skills

Agent skills I've built or augmented from other sources, packaged as a skills.sh source you can install from with the skills CLI.

Each skill is a directory under skills/<name>/ containing a SKILL.md (plus any helper scripts/evals). The skills CLI installs them into whichever AI coding agents you have (Cursor, Codex, Claude Code, and many more).

Available skills

Authored here

Skill	Description
agentsmd-generator	Generate project-level AGENTS.md onboarding guides covering structure, tooling, testing, task flow, and conventions.
bro	Slash-command only (/bro): restate the last message plainly and concisely, without jargon.
jj-case-insensitive-clone-fix	Diagnose and fix the jj git clone "Failed to update refs" error on case-insensitive filesystems (e.g. macOS APFS).
research_codebase	Map how a codebase works today and save a dated, citation-backed report under thoughts/, using parallel sub-agents by default.
sdd-linear	Run the Spec-Driven Development (SDD) workflow with Linear issues, sub-issues, attachments, and comments as the system of record instead of docs/specs.
sync-upstream	Sync a fork's default branch with its upstream remote using merge or rebase, resolving conflicts as needed.
taskfile-automation	Scaffold consistent, portable repo automation with a Taskfile as the single entry point (run the same locally and in CI), adding Docker/Compose only when external runtime deps demand it.
work-breakdown	Decompose large/ambiguous scope into smaller units of work with dependencies and parallelization.

Vendored from upstream

These skills are copied verbatim from their upstream repositories and kept fresh automatically, so they install from this one source alongside the authored skills. They are declared in upstream-skills.toml, copied in by scripts/sync_upstream_skills.py, and refreshed on a schedule by the Sync Upstream Skills workflow. Do not hand-edit skills/<name>/ for these; change the catalog instead. Provenance (source commit and license) is recorded in upstream-skills.lock.json.

Skill	Upstream	License	Description
agent-browser	vercel-labs/agent-browser	Apache-2.0	Browser automation CLI for AI agents (navigate, fill forms, screenshot, scrape, test web/Electron apps).

Some upstream skills set hidden: true, so they will not appear in npx skills add SystemFiles/skills --list. Install them by explicit name, for example npx skills add SystemFiles/skills --skill agent-browser.

Install

List the available skills without installing:

npx skills add SystemFiles/skills --list

Install a single skill (interactive agent selection):

npx skills add SystemFiles/skills --skill work-breakdown

Install to specific agents (e.g. Cursor and Codex):

npx skills add SystemFiles/skills --skill work-breakdown -a cursor -a codex

Install non-interactively (CI-friendly):

npx skills add SystemFiles/skills --skill work-breakdown --yes

Install globally (available across all projects) instead of into the current project:

npx skills add SystemFiles/skills --skill work-breakdown --global

Install every skill in this repo:

npx skills add SystemFiles/skills --skill '*'

Updating and removing

# Update installed skills from this source
npx skills update

# Remove a skill
npx skills remove work-breakdown

Contributing

See CONTRIBUTING.md for how to add or update a skill, run validation (task validate), and the commit/PR conventions.