lythoskill-creator
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).
Full skill instructions
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>
Version placeholder rule: Source packages/<name>/skill/SKILL.md must use version: 0.19.2. The build command substitutes this with the current root package.json version. Never write a literal version (e.g., version: 0.15.5) in source — this breaks future version bumps. If you find a hardcoded version in source, restore the placeholder and rebuild.
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>/.
Analyzes SKILL.md files against Agent Skills best practices. Reviews body size, description quality, progressive disclosure, frontmatter usage, and context efficiency. Provides actionable optimization advice.
A minimal hello-world skill. No scripts, no dependencies. Demonstrates the simplest possible thin-skill: just a SKILL.md.
User-acceptance-driven release workflow using heredoc patch files. Each iteration produces a timestamped pr-<timestamp>-<desc>.sh that self-archives after execution. No tag without explicit user LGTM. Supports rollback via archived backups.
User-acceptance-driven release workflow using heredoc patch files. Each iteration produces a timestamped pr-<timestamp>-<desc>.sh that self-archives after execution. No tag without explicit user LGTM. Supports rollback via archived backups.
Register tasks BEFORE fixing bugs. Close epics when work is done. Always move state through the CLI — never mv files by hand: CLI moves write Status History, manual moves create probe mismatches. Never leave state drift for the next agent to discover via git log. GTD (Getting Things Done)-style g...
Declarative skill deck governance. `deck link` reconciles the working set to match skill-deck.toml — deny-by-default removes undeclared skills. DEFAULT patterns: PHASE SWITCH via separate deck files (deck link --deck phase<N>.toml), SEED bootstrap (minimal deck → agent self-expands via deck add +...
Session context dump. Self-assess what the conversation contains that has NO other carrier (no task, no ADR, no epic) — pitfalls, working-tree anomalies, why-we-chose-this, specific next steps — and write to daily/YYYY-MM-DD.md. Things WITH structured carriers go to their carriers. Things WITHOUT...
Generate, edit, and beat-sync AI video with leading models in one workspace.
The world's fastest calendar for remote work
Transform Your Design with AI Designer by ImgCreator.ai
Revolutionizing Video Production with AI-Powered Creativity
Extend an image past the frame and let AI fill the new aspect ratio.
Discover your celebrity doppelgänger with StarByFace!
ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.
Opus.ai: Revolutionize Your Web Experience