From 9ae47f28772071d0490fb3529fb2a156f85b3e07 Mon Sep 17 00:00:00 2001 From: Yonathan Morales Date: Tue, 29 Sep 2026 05:41:11 +0000 Subject: [PATCH 1/3] =?UTF-8?q?docs(install):=20=F0=9F=A6=89=20add=20a=20c?= =?UTF-8?q?opy-paste=20install=20and=20update=20command?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Publish a curl one-liner that installs or updates git-fix-author from main without requiring a local checkout. Co-authored-by: AIPAL GROK --- README.md | 10 +++++++++- skills/git-fix-author/README.md | 10 +++++++++- 2 files changed, 18 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index d3cc656..a7800a2 100644 --- a/README.md +++ b/README.md @@ -80,7 +80,15 @@ This reduces improvisation without creating an agent-only Git abstraction. ## Install `git fix-author` -Install the reference operation somewhere on `PATH`: +Install or update the reference operation on `PATH`: + +```console +mkdir -p "$HOME/.local/bin" && curl -fsSL \ + https://raw.githubusercontent.com/uklok/git-intent/main/skills/git-fix-author/scripts/git-fix-author \ + -o "$HOME/.local/bin/git-fix-author" && chmod 0755 "$HOME/.local/bin/git-fix-author" +``` + +The same command updates an existing install. From a local checkout: ```console install -m 0755 \ diff --git a/skills/git-fix-author/README.md b/skills/git-fix-author/README.md index 4d3f793..ce8f442 100644 --- a/skills/git-fix-author/README.md +++ b/skills/git-fix-author/README.md @@ -4,7 +4,15 @@ Safely repair author and committer attribution across an inclusive commit range. ## Install -Copy the canonical executable to a directory on `PATH`: +Install or update the canonical executable on `PATH`: + +```console +mkdir -p "$HOME/.local/bin" && curl -fsSL \ + https://raw.githubusercontent.com/uklok/git-intent/main/skills/git-fix-author/scripts/git-fix-author \ + -o "$HOME/.local/bin/git-fix-author" && chmod 0755 "$HOME/.local/bin/git-fix-author" +``` + +The same command updates an existing install. From a local checkout: ```console install -m 0755 \ From 00ebd243010f1d9d2eca2c12401148a01fb609ab Mon Sep 17 00:00:00 2001 From: Yonathan Morales Date: Tue, 29 Sep 2026 05:53:08 +0000 Subject: [PATCH 2/3] =?UTF-8?q?docs(install):=20=F0=9F=A6=89=20install=20v?= =?UTF-8?q?ia=20npx=20skills=20and=20symlink=20PATH?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Keep the installed skill root as the source of truth. Copy-paste npx skills add, then symlink git-fix-author onto PATH instead of copying the executable. Co-authored-by: AIPAL GROK --- README.md | 27 ++++++++++++++++++++------- docs/architecture.md | 6 +++--- skills/git-fix-author/README.md | 27 ++++++++++++++++++++------- 3 files changed, 43 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index a7800a2..84364fd 100644 --- a/README.md +++ b/README.md @@ -80,19 +80,32 @@ This reduces improvisation without creating an agent-only Git abstraction. ## Install `git fix-author` -Install or update the reference operation on `PATH`: +Install the skill the same way as any other community skill: ```console -mkdir -p "$HOME/.local/bin" && curl -fsSL \ - https://raw.githubusercontent.com/uklok/git-intent/main/skills/git-fix-author/scripts/git-fix-author \ - -o "$HOME/.local/bin/git-fix-author" && chmod 0755 "$HOME/.local/bin/git-fix-author" +npx skills add uklok/git-intent -g ``` -The same command updates an existing install. From a local checkout: +The installed skill root remains the source of truth. Expose the same executable +on `PATH` with a symlink; do not copy it: ```console -install -m 0755 \ - skills/git-fix-author/scripts/git-fix-author \ +mkdir -p "$HOME/.local/bin" +ln -sf "$HOME/.agents/skills/git-fix-author/scripts/git-fix-author" \ + "$HOME/.local/bin/git-fix-author" +``` + +Update the skill in place. The symlink keeps resolving to the same file: + +```console +npx skills update git-fix-author -g +``` + +From a local checkout, symlink the tree instead of copying: + +```console +mkdir -p "$HOME/.local/bin" +ln -sf "$PWD/skills/git-fix-author/scripts/git-fix-author" \ "$HOME/.local/bin/git-fix-author" ``` diff --git a/docs/architecture.md b/docs/architecture.md index 0130301..dcb9bc8 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -37,8 +37,8 @@ The README is human-facing packaging documentation. The skill entry point stays compact and routes to references only when their details affect a decision. The executable is the single implementation source. Human installation exposes -the same `git-` file on `PATH`, where Git discovers it as -`git `. +that same file on `PATH` with a symlink into the installed skill root, where Git +discovers it as `git `. ## Stable contracts, replaceable engines @@ -60,4 +60,4 @@ shared need before common machinery is extracted. The repository is a collection of independently useful Agent Skills. Existing skill ecosystems can distribute them; Git Intent does not operate a separate -marketplace. +marketplace. The community install is `npx skills add uklok/git-intent`. diff --git a/skills/git-fix-author/README.md b/skills/git-fix-author/README.md index ce8f442..eb442e0 100644 --- a/skills/git-fix-author/README.md +++ b/skills/git-fix-author/README.md @@ -4,19 +4,32 @@ Safely repair author and committer attribution across an inclusive commit range. ## Install -Install or update the canonical executable on `PATH`: +Install the skill the same way as any other community skill: ```console -mkdir -p "$HOME/.local/bin" && curl -fsSL \ - https://raw.githubusercontent.com/uklok/git-intent/main/skills/git-fix-author/scripts/git-fix-author \ - -o "$HOME/.local/bin/git-fix-author" && chmod 0755 "$HOME/.local/bin/git-fix-author" +npx skills add uklok/git-intent -g ``` -The same command updates an existing install. From a local checkout: +The installed skill root remains the source of truth. Expose the same executable +on `PATH` with a symlink; do not copy it: ```console -install -m 0755 \ - skills/git-fix-author/scripts/git-fix-author \ +mkdir -p "$HOME/.local/bin" +ln -sf "$HOME/.agents/skills/git-fix-author/scripts/git-fix-author" \ + "$HOME/.local/bin/git-fix-author" +``` + +Update the skill in place. The symlink keeps resolving to the same file: + +```console +npx skills update git-fix-author -g +``` + +From a local checkout, symlink the tree instead of copying: + +```console +mkdir -p "$HOME/.local/bin" +ln -sf "$PWD/skills/git-fix-author/scripts/git-fix-author" \ "$HOME/.local/bin/git-fix-author" ``` From ef44ee5c3f9c2c8dff5e59d54b62241e27dc0119 Mon Sep 17 00:00:00 2001 From: Yonathan Morales Date: Tue, 29 Sep 2026 09:14:08 +0000 Subject: [PATCH 3/3] =?UTF-8?q?docs(install):=20=F0=9F=A6=89=20verify=20th?= =?UTF-8?q?e=20symlinked=20operation?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Make the installed operation observable after setup: command resolution proves PATH, and help output proves the executable is runnable. Co-authored-by: AIPAL CODEX (GPT-5) --- README.md | 7 +++++++ skills/git-fix-author/README.md | 7 +++++++ 2 files changed, 14 insertions(+) diff --git a/README.md b/README.md index 84364fd..30e6448 100644 --- a/README.md +++ b/README.md @@ -112,6 +112,13 @@ ln -sf "$PWD/skills/git-fix-author/scripts/git-fix-author" \ Git discovers executables named `git-`, so the installed program is available as either `git-fix-author` or `git fix-author`. +Verify that the symlink resolves to an executable operation: + +```console +command -v git-fix-author +git fix-author --help +``` + Preview an inclusive rewrite range: ```console diff --git a/skills/git-fix-author/README.md b/skills/git-fix-author/README.md index eb442e0..c5de500 100644 --- a/skills/git-fix-author/README.md +++ b/skills/git-fix-author/README.md @@ -35,6 +35,13 @@ ln -sf "$PWD/skills/git-fix-author/scripts/git-fix-author" \ Git exposes `git-fix-author` as `git fix-author`. +Verify that the symlink resolves to an executable operation: + +```console +command -v git-fix-author +git fix-author --help +``` + ## Preview, then execute ```console