CMLs Skills

@cmls/skills is a curated npm package for Codex skills, agents, and goal-loop templates.

It ships two focused bundles:

• diffs: wireframe-first planning, .diffs/ change docs, and the Diffs controller and wireframe architect agents.
• goal-triad: a reusable goal completion loop with gap-scanner, strategist-solidify, sure-polish, support skills, and an empty goal-package template.

Install

Install everything into the current user's Codex scope:

npx @cmls/skills install

Install only one bundle:

npx @cmls/skills install diffs
npx @cmls/skills install goal-triad

Default install targets:

Codex skills: ~/.codex/skills
Codex agents: ~/.codex/agents
Goal package: ~/Downloads/goal-package

Use a custom target for testing:

npx @cmls/skills install all --home /tmp/cmls-home

Preview without writing files:

npx @cmls/skills install all --dry-run

What Gets Installed

Diffs

Skills:

• diffs-wireframe-pipeline
• write-diff-docs

Agents:

• diffs-pipeline-controller
• diffs-wireframe-architect

Goal Triad

Skills:

• goal-triad-pipeline
• auto-mode-trust
• long-running-agent
• smooth-software
• goal-checkpoint
• goal-progress-tracker
• objective-lock-evaluator
• parallel-goal-orchestrator

Agents:

• gap-scanner
• strategist-solidify
• sure-polish
• generic helper agents for planning, exploration, implementation, testing, review, docs, release, and objective orchestration

Template:

• ~/Downloads/goal-package

The template starts empty. It includes GOAL.md, PROGRESS.md, .codex/state/objective-locks.jsonl, scripts, generic agents, and a ready-to-fill Goal Triad pipeline.

Use The Goal Loop

1. Fill in ~/Downloads/goal-package/GOAL.md.
2. Add the current checkpoint and validation commands in PROGRESS.md.
3. Ask Codex to run goal-triad-pipeline for the target project.
4. Keep the objective ledger current when multiple agents or worktrees are active.

The pipeline order is:

1. gap-scanner: read-only completion audit.
2. strategist-solidify: read-only reliability scan.
3. sure-polish: implementation, verification, and final cleanup.

Development

Validate the package:

npm test

Check the npm package contents:

npm run pack:check

Publish:

npm publish --access public

Safety

• The package does not store npm tokens.
• Existing GOAL.md, PROGRESS.md, and objective ledger files are preserved unless --force is used.
• --force backs up an existing goal package before replacing it.
• The public package is checked for local paths, project-specific names, and secret-like values before release.