agent-skills

A library of reusable skills for AI coding agents — plus askill, a small CLI that installs them into your agent's environment.

A skill is a self-contained folder (a SKILL.md plus optional scripts and references) that teaches an agent a repeatable workflow. This repo collects skills under skills/, describes them in a manifest (manifest/registry.json), and ships an installer so any agent — Claude Code first — can pull a skill into ~/.claude/skills/ with one command.

Status: early, under active development. The askill core and the list / info / install / uninstall / wizard commands are implemented and well-tested; a one-line installer and a Claude Code plugin marketplace are live. The remaining commands (update, outdated, search, validate, self-update) are on the roadmap.

Quick install

In Claude Code — native plugin (recommended)

A trusted, first-class install — no permission prompts, no remote-code-execution dance:

/plugin marketplace add Osipchuk/agent-skills
/plugin install skills@askill

That installs the whole library as the skills plugin. Claude picks the right skill by context, or invoke one explicitly as /skills:learning-mode. Non-interactive equivalent: claude plugin marketplace add Osipchuk/agent-skills then claude plugin install skills@askill.

In your terminal

Interactive picker — one command opens a checklist of skills and a scope prompt; check what you want, pick where, Enter:

uvx --from "git+https://github.com/Osipchuk/agent-skills#subdirectory=installer" askill wizard

(Already have the CLI? Just run askill with no arguments.)

Or non-interactively — needs only curl (the script installs uv if it's missing):

# install a skill straight away (user scope -> ~/.claude/skills/):
curl -fsSL https://raw.githubusercontent.com/Osipchuk/agent-skills/main/install.sh | sh -s -- learning-mode

# into the current project instead (-> <cwd>/.claude/skills/):
curl -fsSL https://raw.githubusercontent.com/Osipchuk/agent-skills/main/install.sh | ASKILL_SCOPE=project sh -s -- learning-mode

# or install the askill CLI once, then drive it yourself:
curl -fsSL https://raw.githubusercontent.com/Osipchuk/agent-skills/main/install.sh | sh
askill list
askill install learning-mode

Heads-up: the first install into a project's .claude/skills/ creates that directory; Claude Code doesn't watch a skills directory created mid-session, so restart it (or open a new session) to load the skill. askill prints this reminder when it applies.

Via a non-Claude agent (Cursor, …)

Tell it (replace <skill> with the name you want, e.g. toxic-senior-reviewer):

Install the <skill> skill from the agent-skills library by running this exact command, substituting the skill name I asked for:
uvx --from "git+https://github.com/Osipchuk/agent-skills#subdirectory=installer" askill install <skill> --scope user

Note: in Claude Code, use the plugin install above — its default permission mode (rightly) refuses uvx, since that runs remote code and writes into your ~/.claude. The uvx line is for other agents, or run it yourself in a terminal.

askill CLI

Once installed, askill reads from the published manifest/registry.json by default — no --registry flag needed:

askill                                # interactive wizard (checklist + scope picker)
askill list                           # all skills in the manifest (--json for machine output)
askill info learning-mode
askill install learning-mode --scope user
askill uninstall learning-mode --scope user

Implemented: wizard, list, info, install, uninstall — with --scope user|project, --json on the non-interactive commands, deterministic checksum verification, and the spec's conflict handling (already-installed no-op, version conflicts, --force, --dry-run, --no-checksum). Exit codes: 0 ok, 1 user error, 2 system error, 3 conflict.

Available skills

• learning-mode — turn a Claude Code session into a learn-by-doing tutorial with a spaced-repetition review log.
• article-translator — translate long-form articles and prose between languages while preserving the author's voice, structure, and formatting.
• toxic-senior-reviewer — code review in the voice of a blunt senior dev: sharp criticism only, curt approval when the code is actually good.

From source (development)

Run it from a clone with uv, pointing at the local manifest:

git clone https://github.com/Osipchuk/agent-skills
cd agent-skills/installer
uv sync

uv run askill list   --registry ../manifest/registry.json
uv run askill install learning-mode --registry ../manifest/registry.json --scope user
uv run pytest

Authoring a skill

A skill is a folder skills/<name>/ with a SKILL.md whose frontmatter carries name, a trigger-oriented description, and a pinned version. Bulky helpers live in scripts/ and references/ and are pulled in on demand (progressive disclosure). Presentation metadata (summary, tags, etc.) lives in catalog/<name>.yaml. See CONTRIBUTING.md for the full format and a checklist.

Roadmap

• One-line bootstrap (curl … | sh) and a default published registry
• Claude Code plugin marketplace (/plugin install skills@askill)
• Interactive wizard (askill wizard — checklist + scope picker)
• update, outdated, search, validate
• self-update
• Multi-agent adapters (Codex, Cursor)

Contributing

Contributions of skills and CLI improvements are welcome — see CONTRIBUTING.md.

License

MIT.