English | 中文

adonis-skills

Agent-agnostic skills for coding agents: review loops, workflow gates, MCP setup, Git delivery, and local environment audits. Install them into Claude Code, Codex, Cursor, Hermes, or any agent that reads SKILL.md.

Live site: https://adonis-skills.vercel.app/

Quick Start

Examples:

npx skills add adonis0123/adonis-skills --skill workflow-gate
npx skills add adonis0123/adonis-skills --skill chrome-dev-mcp -g
npx skills add adonis0123/adonis-skills --list

Skills

Recommended Third-Party Skills

These skills are maintained elsewhere and are not copied into this repository. Install them from their own repositories.

How It Works

flowchart LR
  src["Private source<br/>(single copy of each skill)"] --> exp["Allowlist export<br/>+ privacy scan"]
  exp -->|"one fresh commit"| repo["adonis-skills<br/>skills/&lt;name&gt;/SKILL.md"]
  repo --> ci["CI: skills:validate,<br/>skills:index, gitleaks"]
  repo --> cc["Claude Code<br/>plugin marketplace"]
  repo --> npx["npx skills<br/>Codex, Cursor, others"]
  repo --> hm["Hermes<br/>skills tap"]
  repo --> web["Web catalog<br/>adonis-skills.vercel.app"]

• Some skills (dev-environment-roi-audit, desktop-agent-activity, agent-skill-evaluation) are exported from a private source. Machine- or company-specific details stay in references/local-*.md files that are never exported.
• Third-party skills are only linked, never vendored.
• Every skill is a directory skills/<name>/ with a SKILL.md whose frontmatter name equals the directory name.

For AI Agents

• Read AGENTS.md for repository rules, commands, and skill authoring conventions.
• llms.txt gives a short map of this repository.
• Install one skill: npx skills add adonis0123/adonis-skills --skill <name>; list them with --list.

Related

• Adonis0123/hermes-kit: Hermes plugins and Hermes-only skills.

Develop This Repository

This repository is a pnpm + Turborepo + Next.js 16 monorepo. Goals:

• Make skills directly installable via npx skills add
• Provide a web UI that presents skill metadata and install commands
• Keep room for future evolution (more skills, optional npm publishing)

Layout:

.
├── .claude-plugin/marketplace.json   # Claude Code marketplace manifest
├── apps/web/                          # Next.js 16 web catalog
├── skills/<name>/SKILL.md             # public skills (indexed by the web app)
├── .agents/skills/                    # internal tooling skills (not indexed)
├── scripts/
│   ├── generate-skills-index.mjs      # skills index generation
│   └── validate-skills.mjs            # skills structure validation
├── turbo.json
├── pnpm-workspace.yaml
└── .github/workflows/                 # ci.yml, privacy-scan.yml

Local development:

pnpm install
pnpm skills:validate
pnpm skills:index
pnpm dev

Open http://localhost:3000 in your browser.

If the repository owner changes:

1. Set NEXT_PUBLIC_SKILLS_REPO=<new-owner>/adonis-skills (for example in .env.local)
2. Restart pnpm dev (or redeploy) to apply the new value

Command Cheatsheet (What Each Command Does)

The table below explains each script in package.json.

Notes:

• Default repository validation (no skill path): skills:validate
• Most common flow for new skills: skills:new -> skills:validate -> skills:index
• Most common manual flow: skills:init (or copy manually) -> skills:finalize -- <skill-path>

New Skill Standard Flow (SOP)

Prepare-and-stage mode (use only when you already added/copied a skill under skills/* and want those new files staged):

pnpm skills:finalize:new

Dry-run preview:

pnpm skills:finalize:new -- --dry-run

Recommended quick path:

pnpm skills:new

By default it interactively collects name, description, optional resource directories, then runs:

1. Initialize skill directory (default path: skills/)
2. Single-skill quick validation (skills:quick-validate)
3. Repository-wide validation (skills:validate)
4. Index regeneration (skills:index)

Non-interactive creation example:

pnpm skills:new -- --name demo-skill --description "Used to demonstrate the new skill workflow" --resources scripts,references --non-interactive

Manual mode (initialize or copy first, then finalize):

pnpm skills:init <skill-name> --path skills --resources scripts,references
pnpm skills:finalize -- skills/<skill-name>

Finalize only (no re-initialization needed):

# Relative path
pnpm skills:finalize -- skills/code-inspector-init

# Absolute path (trailing / is handled automatically)
pnpm skills:finalize -- "$REPO_ROOT/skills/code-inspector-init/"

# Preview commands only; do not execute
pnpm skills:finalize -- --dry-run skills/code-inspector-init

Local Interactive Install and Testing

This repository supports installing skills from skills/ into .agents/skills. .claude/skills should be a symlink to .agents/skills for local Claude/Codex runtime testing.

# Default: enter interactive menu (select + checkbox)
pnpm skills:install:local

# Interactive install, then ensure the .claude/skills symlink
pnpm skills:test:local

Interactive menu flow:

1. Choose Install selected skills / Install all skills / Exit
2. If choosing selected install, go into multi-select list (space to check)
3. Confirm and execute install

Non-interactive mode is also supported:

# Install one skill (repeat --skill if needed)
pnpm skills:install:local -- --no-interactive --skill weekly-report

# Install all
pnpm skills:install:local -- --no-interactive --all

# Install then ensure the local runtime symlink
pnpm skills:test:local -- --no-interactive --skill weekly-report

Notes:

• Install command uses npx skills add ./skills -a codex ... under the hood, target directory is .agents/skills
• skills:test:local runs the same install flow with --sync-llm, which verifies or creates .claude/skills -> ../.agents/skills

CI

GitHub Actions runs:

• pnpm install --frozen-lockfile
• pnpm skills:validate
• pnpm skills:index
• pnpm --filter @adonis-skills/web run i18n -- --compile --strict
• pnpm turbo run lint typecheck build --filter=@adonis-skills/web

What each step validates:

• install: lockfile-consistent dependency install
• skills:validate: frontmatter/schema validity for skills/*
• skills:index: regenerates apps/web/src/generated/skills-index-lite.json, skills-detail-index.json, and skills-catalog-layout.json
• Prepare i18n Catalogs: compiles src/locales/**/*.po into *.mjs and regenerates src/i18n/catalog-manifest.ts
• lint/typecheck/build: code quality, TS correctness, and production buildability

Why the i18n step is required:

• compiled Lingui catalogs (src/locales/**/*.mjs) are intentionally ignored by git.
• src/i18n/catalog-manifest.ts imports those .mjs files.
• without pre-compiling catalogs in CI, typecheck can fail with TS2307 ("Cannot find module .../src/locales/.../*.mjs").

Common failure categories:

• dependency/install issue (pnpm install)
• skills validation failure (pnpm skills:validate)
• i18n compile/translation strict check failure (Prepare i18n Catalogs)
• TypeScript module/type errors (typecheck)

Troubleshooting rule:

• if you see TS2307 paths pointing to src/locales/**/*.mjs, run pnpm --filter @adonis-skills/web run i18n -- --compile first, then rerun typecheck.

Failures block merge to keep the main branch deployable.

A separate privacy-scan workflow runs gitleaks with .gitleaks.toml (default secret rules plus generic local-path, hostname, and loopback-port rules) on every push and pull request.

Vercel Deployment (Automatic)

Recommended Vercel settings for this repository:

• Install Command: pnpm install --frozen-lockfile
• Build Command: pnpm turbo run build --filter=@adonis-skills/web
• Output: default Next.js output (no manual override)

After main branch updates, Vercel deploys automatically. If a bad release appears, revert to the previous green commit on GitHub.

Future Plan

V1 supports GitHub installation flow only. Later we can add npm publishing (including GitHub Action release and rollback strategy).

License

MIT. Third-party skills listed above keep their own licenses.