v1.0.0

coding-skill v1.0.0

Six behavioral guidelines for AI coding assistants. Works with Claude Code, Codex CLI, and Gemini CLI.

Install

npm install -g @zigrivers/coding-skill
coding-skill init

What's included

• Cross-CLI support — generates CLAUDE.md, AGENTS.md, and GEMINI.md from a single source
• 5 CLI commands — init, update, doctor, diff, eject
• Per-principle configuration — toggle individual principles, add custom content
• Marker-based managed sections — user content outside markers preserved on update
• Safe lifecycle — --yes for CI automation, --force for intentional reset, eject for clean exit
• Zero runtime dependencies — Node.js built-ins only
• 62 tests — unit + integration lifecycle coverage
• Claude Code plugin — also installable as a skill for auto-invocation

Six Principles

1. Think Before Coding — surface assumptions, present alternatives
2. Simplicity First — minimum code, no speculative features
3. Surgical Changes — touch only what the task requires
4. Goal-Driven Execution — define success criteria, loop until verified
5. Communicate Progress — narrate steps before executing
6. Trace Before Building — enumerate system states before crossing module boundaries

Derived from Andrej Karpathy's observations on LLM coding pitfalls.

Full changelog: CHANGELOG.md