Skip to content
Skribly Docs

Install agent-skills

Requirements

Section titled “Requirements”
  • git and Node.js 20 or newer (node --version). No npm packages are installed: the CLI and every skill script use only Node’s standard library.
  • At least one supported agent: Claude Code, Codex CLI, Cursor, Gemini CLI, OpenCode, Windsurf or GitHub Copilot.

Install in a minute

Section titled “Install in a minute”

  1. Clone the repository and put the command on your PATH:

    Terminal window
    git clone https://github.com/skribly/agent-skills.git ~/agent-skills
    cd ~/agent-skills
    npm link

  2. Install every skill for every agent, at user scope:

    Terminal window
    agent-skills install --target all

  3. Turn off Claude Code’s own attribution and check the result:

    Terminal window
    agent-skills config attribution off
    agent-skills doctor

  4. Restart your agent, or open a new chat, so it reads its skills folder again. Then try /task 123 in Claude Code or $task 123 in Codex.

On Windows use the same commands in PowerShell with $HOME\agent-skills. Folder links are created as junctions, which need no administrator rights. Without npm link, run node cli/agent-skills.mjs … or bin\agent-skills.cmd ….

User scope or project scope

Section titled “User scope or project scope”
User scope (default) Project scope
Command agent-skills install --target all agent-skills install --target all --project ~/code/shop
Where ~/.claude/skills, ~/.agents/skills, … <project>/.claude/skills, <project>/.agents/skills, …
How Symlinks to the repository Copies
Updates git pull, then agent-skills sync agent-skills sync after git pull
Good for Your own machine, all projects Sharing with a team through the project’s repository

A project-scope install also detects the project profile, .skribly/project.json; pass --no-detect to skip it.

You can mix them: install everything at user scope and commit task and commit into a team project so colleagues get them too. Choose explicitly with --scope user|project, --link or --copy.

Choose skills and agents

Section titled “Choose skills and agents”
Terminal window
agent-skills install --target claude,codex --skills task,commit,handoff,review,test-loop,token-saver
agent-skills list

--target takes claude, codex, cursor, gemini, opencode, windsurf, copilot or all. --format rules writes the classic formats for older agent versions; see Supported agents.

Section titled “Recommended setup”
Terminal window
agent-skills config attribution off             # Claude Code: no Co-Authored-By trailer or PR footer
cd ~/code/shop && agent-skills hooks install    # per repository: strip AI trailers from any tool

Then configure your tracker as in Trackers.

Update and remove

Section titled “Update and remove”
Terminal window
cd ~/agent-skills && git pull && agent-skills sync      # refresh everything that was installed
agent-skills uninstall --target all                     # user scope
agent-skills uninstall --target all --project ~/code/shop

Installs are recorded in ~/.config/agent-skills/installs.json with a hash of each file. uninstall removes only what agent-skills installed, keeps files you edited unless you pass --force, and deletes folders it leaves empty. A file agent-skills did not write is never overwritten; with --force it is moved to <path>.bak-agent-skills first.

CLI reference

Section titled “CLI reference”
Command Purpose
agent-skills list [--json] The catalogue
agent-skills install --target <agents|all> [--scope user|project] [--project <dir>] [--skills a,b] [--link|--copy] [--format skills|rules] [--dry-run] [--force] Install
agent-skills uninstall --target … [--scope] [--project] [--skills] Remove only what was installed
agent-skills sync Re-apply every recorded install after git pull
agent-skills project [--project <dir>] [--dry-run] [--json] Detect the project into .skribly/project.json, keeping values set by hand
agent-skills doctor [--project <dir>] [--json] Agents, installs, trackers, hook and attribution
agent-skills hooks install|uninstall|status [--project <dir>] The commit-msg hook
agent-skills config attribution off|on|status [--project <dir>] Claude Code attribution
agent-skills tasks fetch|attachments|list|comment-draft|event|detect|check The tracker client; event prints the skills.task.completed event of a task
agent-skills manifest [--check|--write] Validate skills, sync shared files, regenerate skills.json

With Skribly Agent

Section titled “With Skribly Agent”

Skribly Agent clones agent-skills, shows the catalogue from skills.json (a stable v1 contract with a JSON schema), installs the chosen skills per project and per agent through this CLI, and can ask an agent to adapt them to the project. It runs the CLI with its own runtime, so no separate Node.js is needed there.