skillflag

Reference (TypeScript) implementation of the Skillflag convention: a minimal CLI interface for bundling, listing, and installing agent skills without a third-party registry.

This package ships:

• the embeddable producer library (maybeHandleSkillflag, findSkillsRoot),
• the standalone skillflag binary,
• the skill-install adaptor that installs exported skills into agent tools (Claude Code, Codex, Amp, Goose, and others).

Install

npm install -g skillflag
# or run one-off with npx
npx skillflag list

Embed in your CLI

import { findSkillsRoot, maybeHandleSkillflag } from "skillflag";

await maybeHandleSkillflag(process.argv, {
  skillsRoot: findSkillsRoot(import.meta.url),
});

Then ship a skills/<skill-id>/SKILL.md directory in your package. Users install your skill with:

your-tool --skill export <id> | npx skillflag install --agent claude --scope repo

Documentation

• Skillflag specification
• Integration guide

Go, Python, and Rust implementations of the same standard live in the same repository.

License

MIT