By name: lythoskill-creator version: {{PACKAGE_VERSION}} description: | 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). when_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).
lythoskill-creator
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:
- Starter (
packages/<name>/): npm-publishable package with CLI. All dependencies managed here. - Skill (
packages/<name>/skill/): Thin SKILL.md + scripts that call the starter viabunx. - Output (
skills/<name>/): Build output copied from Skill layer. Committed to Git so consumers can clone and use without building.
Scripts
init
Scaffold a new lythoskill monorepo.
bunx @lythos/skill-creator@{{PACKAGE_VERSION}} init <project-name>
Creates a monorepo with a starter package and an example skill.
add-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/skill-creator@{{PACKAGE_VERSION}} 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 |
- Skill + CLI:
add-skillcreatespackages/<name>/withpackage.json+src/cli.ts+skill/SKILL.md. Add toscripts/publish.shPACKAGES array. - Pure skill: Create
packages/<name>/skill/SKILL.mddirectly. No package.json, no CLI, no npm. Distribution via cold pool (git clone / localhost). The pre-commit build hook auto-createsskills/<name>/output.
After creation: run bunx @lythos/skill-creator build <name> to build the skill output, then git add skills/<name>/.
build
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/skill-creator@{{PACKAGE_VERSION}} build <skill-name>
Build all skills at once (used by pre-commit):
bunx @lythos/skill-creator@{{PACKAGE_VERSION}} build --all
align
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/skill-creator@{{PACKAGE_VERSION}} align
# Auto-fix drift where possible
bunx @lythos/skill-creator@{{PACKAGE_VERSION}} align --fix
Checks for: outdated package.json scripts, stale .gitignore patterns, missing skill-layer boilerplate, and version mismatches.
bump
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/skill-creator@{{PACKAGE_VERSION}} bump patch
bunx @lythos/skill-creator@{{PACKAGE_VERSION}} bump minor
bunx @lythos/skill-creator@{{PACKAGE_VERSION}} bump major
# Explicit version (e.g. for major milestones)
bunx @lythos/skill-creator@{{PACKAGE_VERSION}} bump 1.0.0
# Preview the bump without writing files
bunx @lythos/skill-creator@{{PACKAGE_VERSION}} bump 1.0.0 --dry-run
Run from the project root. Expects source at packages/<name>/skill/ and outputs to skills/<name>/.