Documentation

AutoSkillsis a tiny CLI that does one thing: scan your project, fetch the matching community-curated AI context (skills, tools, rules), and install it into your AI assistant's config directory.

Install

No install needed — just run:

Or install globally with npm install -g autoskills.

Commands

autoskills                          # scan + install for cwd
autoskills /path/to/project         # for a specific path
autoskills --dry-run                # show what would be installed
autoskills --tags react,tailwind    # force-include tags
autoskills --items pest-testing     # install specific items only
autoskills --scan-only              # show detected tags, install nothing
autoskills --related                # include related tags
autoskills --no-verify              # skip checksum verification (not recommended)

autoskills scan                     # show detected tags + framework
autoskills scan --json              # JSON output for piping
autoskills list                     # list everything in the registry
autoskills list --tags laravel      # filter list by tag
autoskills status                   # show what is installed
autoskills doctor                   # validate the install
autoskills remove --all             # uninstall everything
autoskills remove --item <name>     # uninstall one

How detection works

• Stack signatures — looks at package.json, composer.json,Cargo.toml, pubspec.yaml, requirements.txt, and 50+ other markers to identify your stack.
• AI framework — detects .claude/, .cursor/,.windsurf/, .codex/ directories or their associated config files.
• Tag matching — each registry item has tags. The CLI fetches items whose tags overlap with your detected stack.
• Framework adaptation — the manifest uses .claude/ as the canonical install prefix; the CLI rewrites it to .cursor/, .windsurf/, etc. based on what you have.
• Checksum verification — every fetched file is verified against the SHA-256 in the manifest before being written. Tampered content is rejected with an error.

Configuration

Environment variables (mainly for testing forks):

AUTOSKILLS_REGISTRY_OWNER=my-fork \
AUTOSKILLS_REGISTRY_REPO=autoskills \
AUTOSKILLS_REGISTRY_BRANCH=staging \
AUTOSKILLS_HOME=/path/to/state-dir \
npx autoskills

Where things land

Install targets are framework-adapted from the canonical .claude/ prefix:

• Claude Code → .claude/skills/<name>/SKILL.md
• Cursor → .cursor/skills/<name>/SKILL.md
• Windsurf → .windsurf/skills/<name>/SKILL.md
• Codex → .codex/skills/<name>/SKILL.md

Local state

AutoSkills tracks installs in SQLite at ~/.autoskills/registry.db. Nothing leaves your machine.

Browse the registry