agent-skills guide
Install skills for your agents, choose the ones you need and connect a tracker. No npm packages are installed: the command line and every skill script use only Node's standard library.
The repositories are private for now, so nothing here can be installed yet. These pages describe how the apps work today.
What you need
git- Node.js 20 or newer
- At least one of Claude Code, Codex CLI, Cursor, Gemini CLI, OpenCode, Windsurf or GitHub Copilot
Install
From a clone of the repository:
npm link
agent-skills install --target all
agent-skills config attribution off
agent-skills doctornpm link puts agent-skills on your PATH and is optional. On Windows, the same commands work in PowerShell, and directory links are junctions, which need no administrator rights.
Restart the agent or open a new chat after installing, so it reads its skills folder again.
User scope or project scope
Scrollable table
| Aspect | User scope | Project scope |
|---|---|---|
| Command | agent-skills install --target all | agent-skills install --target all --project ~/code/app |
| Where | ~/.claude/skills, ~/.agents/skills | .claude/skills, .agents/skills in the project |
| How | Symlinks to the repository | Copies |
| Updates | git pull, then agent-skills sync | agent-skills sync after git pull |
| Good for | Your own machine and all projects | Sharing with a team through the repository |
You can mix them: install everything at user scope, and commit task and commit into a team project.
Per agent
Scrollable table
| Agent | Target | Folder in the project | Call a skill |
|---|---|---|---|
| Claude Code | claude | .claude/skills/<name>/ | /task 123 |
| Codex CLI | codex | .agents/skills/<name>/ | $task 123 |
| Cursor | cursor | .agents/skills/<name>/ | /task 123 |
| Gemini CLI | gemini | .agents/skills/<name>/ + .gemini/commands/<name>.toml | /task 123 |
| OpenCode | opencode | .agents/skills/<name>/ + .opencode/commands/<name>.md | /task 123 |
| Windsurf | windsurf | .agents/skills/<name>/ + .windsurf/workflows/<name>.md | /task 123, @task |
| GitHub Copilot | copilot | .agents/skills/<name>/ | /task 123 |
Install for one agent with --target, for example agent-skills install --target claude.
Choose skills
Install a subset with --skills, for example only the daily workflow:
agent-skills install --target claude,codex --skills task,commit,handoff,review,test-loop,token-saverKeep commits yours
Three independent layers keep AI attribution out of your history:
- Skills never add a trailer, and they commit only after your OK.
agent-skills config attribution offturns off Claude Code's commit trailer and pull request footer.agent-skills hooks installadds acommit-msghook that strips AI trailers from any tool.
The hook leaves the rest of the message byte for byte. Your existing hook keeps running after it. Hooks are per repository.
Connect a tracker
Credentials come from environment variables or ~/.config/agent-skills/credentials.env, never from the repository.
agent-skills tasks check
agent-skills tasks list
agent-skills tasks fetch 482The first fetch writes .tasks/<id>/TASK.md. Later fetches print only what changed. Fetched tickets stay out of commits, because .tasks/ is excluded locally.
Commands
| Command | What it does |
|---|---|
agent-skills list | Prints the catalogue |
agent-skills install | Installs skills for chosen agents |
agent-skills uninstall | Removes only what it installed |
agent-skills sync | Applies every recorded install again after git pull |
agent-skills doctor | Shows agents, installs, trackers, the hook and attribution |
agent-skills hooks | Installs, removes or checks the commit-msg hook |
agent-skills config attribution | Turns Claude Code attribution off or on |
agent-skills tasks | Fetches and lists tracker tasks |
Files you did not install, or edited by hand, are never overwritten or deleted without --force.
Keep reading
- See how it saves tokens
Measured savings from real projects.
- Open the catalogue
All 27 skills.
- Check your agent
What works with each one.