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:

• .search file 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.