Stats
Actions
Tags
From lythoskill
Scaffold and build projects for the lythoskill ecosystem only. Creates thin-skill monorepos: heavy logic in npm packages (Starter), agent-facing instructions in lightweight SKILL.md (Skill), build output committed to skills/ (Output).
How this skill is triggered — by the user, by Claude, or both
Slash command
/lythoskill:lythoskill-creatorWhen to use
Scaffold a lythoskill monorepo, init a lythoskill project, add a skill to an existing lythoskill repo, build a skill that follows the thin-skill pattern (Starter + Skill + Output), lythoskill skill template, new lythoskill repository. NOT for: writing a generic skill (just create SKILL.md directly), creating a plain npm CLI tool (use your usual scaffolding).
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
> **Not a generic skill creator.** This scaffolds projects for the lythoskill ecosystem only.
Not a generic skill creator. This scaffolds projects for the lythoskill ecosystem only. If you just want to write a skill, create a
SKILL.mdfile directly — no tooling needed.
A lythoskill project separates concerns into three layers:
packages/<name>/): npm-publishable package with CLI. All dependencies managed here.packages/<name>/skill/): Thin SKILL.md + scripts that call the starter via bunx.skills/<name>/): Build output copied from Skill layer. Committed to Git so consumers can clone and use without building.Scaffold a new lythoskill monorepo.
bunx @lythos/[email protected] init <project-name>
Creates a monorepo with a starter package and an example skill.
Add a new skill to an existing lythoskill monorepo. Follows the cortex Step 1/2/3 pattern: CLI creates template → agent fills content → probe verifies.
bunx @lythos/[email protected] add-skill <skill-name>
Step 1 (CLI): Creates packages/<skill-name>/skill/SKILL.md template.
Step 2 (agent): Edit SKILL.md — fill description, when_to_use, body, gotchas.
→ After editing, run bunx @lythos/skill-coach to validate against 12-dimension quality rubric.
→ Fix issues coach flags, then proceed to Step 3.
Step 3 (verify): Run cortex probe to confirm no empty-shell template.
Two skill types, decided upfront:
| Type | Has CLI? | Has package.json? | npm publish? | Example |
|---|---|---|---|---|
| Skill + CLI | ✅ bin field | ✅ required | ✅ to npm | deck, arena, curator, cortex |
| Pure skill | ❌ no CLI | ❌ none needed | ❌ skip | scribe, onboarding, coach, journalist |
add-skill creates packages/<name>/ with package.json + src/cli.ts + skill/SKILL.md. Add to scripts/publish.sh PACKAGES array.packages/<name>/skill/SKILL.md directly. No package.json, no CLI, no npm. Distribution via cold pool (git clone / localhost). The pre-commit build hook auto-creates skills/<name>/ output.After creation: run bunx @lythos/skill-creator build <name> to build the skill output, then git add skills/<name>/.
Build a skill for distribution. Copies packages/<name>/skill/ to skills/<name>/, strips dev-only files, validates SKILL.md frontmatter, and enforces the unified version.
bunx @lythos/[email protected] build <skill-name>
Build all skills at once (used by pre-commit):
bunx @lythos/[email protected] build --all
Audit an existing project against current lythoskill conventions. Reports drift between your project and the latest scaffolding standards.
# Audit only — reports what would change
bunx @lythos/[email protected] align
# Auto-fix drift where possible
bunx @lythos/[email protected] align --fix
Checks for: outdated package.json scripts, stale .gitignore patterns, missing skill-layer boilerplate, and version mismatches.
Lock-step version bump for the entire monorepo. Updates root package.json + every packages/*/package.json to the same version (per project_lockstep_versioning policy). Used before npm publish runs.
# Semver targets
bunx @lythos/[email protected] bump patch
bunx @lythos/[email protected] bump minor
bunx @lythos/[email protected] bump major
# Explicit version (e.g. for major milestones)
bunx @lythos/[email protected] bump 1.0.0
# Preview the bump without writing files
bunx @lythos/[email protected] bump 1.0.0 --dry-run
Run from the project root. Expects source at packages/<name>/skill/ and outputs to skills/<name>/.
npx claudepluginhub lythos-labs/lythoskill --plugin lythoskill-governanceCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.