Skill-Plus
Compilable skill packages for content-generation agents.
npm i -g @e8s/skillplus
skillplus list # browse the official catalog
skillplus search "phone snapshot food" # find a skill by keyword
skillplus show food-street-realism # see metadata
skillplus food-street-realism --target skill-md > ~/.claude/skills/food.md
A skill is a directory of YAML + Markdown that the compiler turns into one of several target formats: structured JSON for the OpenMelon runtime, a portable skill.md for Claude Code / Cursor / any agent, vendor-specific prompt bundles, evaluation checklists, or provenance templates. The compiler is deterministic and never calls a model — that's the runtime's job.
Install
npm i -g @e8s/skillplus
Requires Node ≥20.
Commands
skillplus <id-or-path> [--target ...] [--model-profile ...] [--locale ...] compile
skillplus list [--tag <t>] [--mine] [--json] list available skills
skillplus search <query> [--json] fuzzy search
skillplus show <id> [--json] print metadata
skillplus copy <id> [--force] fork a bundled skill into ~/.skillplus/local/
skillplus init <id> [--from <existing>] scaffold a new skill
skillplus update [--check] [--dry-run] self-update via npm
skillplus <cmd> --help for flags.
Compile
# By skill id (resolves against ~/.skillplus/local/ first, then bundled)
skillplus food-street-realism --target openmelon --locale zh-CN
# By path (local development)
skillplus ./my-package.skillplus --target skill-md
# Drop-in for Claude Code
skillplus food-street-realism --target skill-md > ~/.claude/skills/food.md
Targets: openmelon, skill-md, prompt-bundle, eval, provenance.
Browse the catalog
skillplus list shows everything available — bundled official skills plus your own under ~/.skillplus/local/. Local takes precedence in resolution: skillplus copy food-street-realism makes a local fork, which then shadows the official version.
ID VERSION SOURCE DESCRIPTION
---------------------------------------------------
brand-logo 0.1.0 bundled Single-mark brand logos for OSS, dev tools…
food-street-realism 0.1.0 bundled Real-feeling phone-snapshot food posts…
Update
skillplus update --check # see if a newer version exists
skillplus update # install it
This runs npm install -g @e8s/skillplus@latest under the hood. Mirrors claude update.
Featured skills
Curated picks from the catalog (full list: skills/README.md or skillplus list).
Skill What it does
food-street-realism Real-feeling phone-snapshot food posts for 探店 / Xiaohongshu
brand-logo Flat-vector brand logos that read at favicon size
Contribute
Skill-Plus grows with the community. New skills are accepted via PR.
The contribution path is short:
skillplus init my-skill # scaffold ./my-skill.skillplus/
# fill in the TODOs (skillplus.yaml, .search, prompts/, schema/, eval/)
skillplus my-skill --target openmelon --locale en # compile to verify
# open a PR moving ./my-skill.skillplus/ into skills/
Required for acceptance:
-
.searchfile with a description (≤200 chars) and 1-10 kebab-case tags -
Manifest fields per SPEC.md
-
At least one locale, one model profile, one base prompt
-
Evaluation checklist + failure modes
-
A real example input
-
Demonstrably useful (not a "tweak the temperature" reskin of an existing skill)
See CONTRIBUTING.md for the full submission requirements + featured-tier criteria.
Public API
import { compilePackage, renderTarget, CompileError } from "@e8s/skillplus"
const compiled = compilePackage({
packageDir: "./food-street-realism.skillplus",
target: "openmelon",
modelProfile: "gpt-image-family",
locale: "zh-CN",
varsOverride: { realism_level: "high" },
})
const { text } = renderTarget(compiled)
Vendor model profiles
Per-vendor prompt-style preferences and gotchas live in model-profiles/. Today: Anthropic Claude. More coming.
License
MIT.