srinitude skills

Portable Agent Skills from one canonical source tree.

This repository packages portable skills that follow the Agent Skills specification.

Install with skills.sh

What ships

  • Canonical skill packages under skills/.
  • Trigger, behavior, failure, recovery, and speed evaluations.
  • A bundled, read-only local MCP server.
  • Native plugin metadata or an honest adapter for ten clients.
  • Strict JSON Schemas for manifests, reports, benchmarks, and checkpoints.

No client integration contains a second skill body.

GitHub release versions and skill metadata versions are independent. Skills don't depend on each other's versions.

Install

npx skills add srinitude/skills

Use npx skills add srinitude/skills --list to inspect available skills first. The CLI reports anonymous install telemetry to skills.sh unless DISABLE_TELEMETRY=1 is set.

Clone the repository and run npm ci --include=dev plus npm run build:mcp when developing the package. Node 24 or newer is required. Mise pins the full local toolchain.

Client support

Client Route Local MCP
Claude Code Root plugin and marketplace Yes
Codex Root plugin and marketplace Yes
ChatGPT Codex plugin format Yes
Gemini CLI Root extension Yes
Cursor Root local plugin No claim
OpenClaw Root native plugin Skills only
Hermes Agent Root Python plugin Skills only
opencode Project config plus skills install Yes
Continue Skills CLI adapter Optional
Aider Read-only config No

Claude Code

/plugin marketplace add srinitude/skills
/plugin install srinitude-skills@srinitude-skills

The plugin loads ./skills and .mcp.json from the same checkout.

Codex and ChatGPT

Start Codex with plugin support, open /plugins, add srinitude/skills as a marketplace, and install srinitude-skills.

codex --enable plugins

The same package metadata is the ChatGPT plugin route documented by the Codex plugin format.

Gemini CLI

gemini extensions install https://github.com/srinitude/skills

gemini-extension.json starts the bundled MCP server from the installed extension path.

Cursor

The root .cursor-plugin/plugin.json uses automatic skills/ discovery. Load the checkout as a local plugin. This repository does not claim a Cursor Marketplace listing.

OpenClaw

Use the tag-pinned native plugin route and cold-discovery check in the OpenClaw adapter note.

Hermes Agent

Use the Skills Hub tap or optional Python plugin route in the Hermes Agent adapter note. Both load the existing SKILL.md path.

opencode

Use the repository installation above. opencode.json starts the local MCP server when running opencode from this checkout.

Continue and Aider

Use the Continue adapter note or Aider adapter note. Both point to the canonical SKILL.md rather than copying it.

Local MCP server

Build it with:

npm run build:mcp

The stdio server exposes six read-only tools:

  • list_skills
  • search_skills
  • get_skill
  • get_reference
  • get_eval_manifest
  • validate_skill

Paths are confined to the repository skill tree. Absolute paths, traversal, hidden files, nested references, and symlink escapes fail closed. The server has no write tool, telemetry, credentials, or network call.

Validate and evaluate

SKILL_NAME=your-skill-name
npm run skills -- validate --all --report .artifacts/skill-validation.json
npm run skills -- eval --skill "$SKILL_NAME" --transport fixture --report ".artifacts/evals/$SKILL_NAME-fixture"
npm run skills -- benchmark --skill "$SKILL_NAME" --transport fixture --samples 1000 --report ".artifacts/benchmarks/$SKILL_NAME-fixture.json"

Fixture results prove runner behavior only. They are not evidence about a language model. Paid OpenRouter evaluation is a separate post-release step with a frozen model inventory, checkpoint files, a cost estimate, and explicit spend approval.

Use the fixed-route, capped procedure in OpenRouter sweeps.

Run the complete local gate with:

mise run ci

Contribute and report problems

Read CONTRIBUTING.md before changing a skill or integration. The skills.sh publishing notes record discovery, telemetry, API, and listing-correction rules. Security reports follow SECURITY.md. Other help is covered by SUPPORT.md.

License

MIT