claude-skills

mirror of https://github.com/alirezarezvani/claude-skills.git synced 2026-08-28 04:24:58 +00:00

History

Reza Rezvani 17cf7dfc62 feat(engineering): add karpathy-coder — active coding discipline enforcer Implements Karpathy's 4 coding principles (Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution) as an active enforcement plugin, not just passive guidelines. Derived from Karpathy's X post on LLM coding pitfalls but goes far beyond the source material with automated detection tools, a review agent, and CI integration patterns. Differentiator vs forrestchang/andrej-karpathy-skills (prompt-only, single SKILL.md): this version ships real tooling that DETECTS violations instead of just documenting principles. Plugin contents (engineering/karpathy-coder/): - SKILL.md with `context: fork` for skill chaining - 4 Python tools (stdlib only): - complexity_checker.py — cyclomatic complexity, class density, nesting depth, function length, premature abstractions (Principle #2) - diff_surgeon.py — diff noise ratio: comment-only changes, whitespace, style drift, drive-by refactors, quote-style swaps (Principle #3) - assumption_linter.py — detects "just", "obviously", "should work", vague actions, unscoped users, missing format specs (Principle #1) - goal_verifier.py — scores plan steps 0-3 for verification quality, flags vague criteria, checks for final verification (Principle #4) - 1 sub-agent: karpathy-reviewer (runs all 4 principles against a diff) - 1 slash command: /karpathy-check (dispatches the reviewer) - 1 pre-commit hook: karpathy-gate.sh (non-blocking, warns on violations) - 3 reference docs: karpathy-principles.md (full context + when to relax), anti-patterns.md (10+ before/after examples), enforcement-patterns.md (Husky, pre-commit framework, GitHub Actions CI integration) - .claude-plugin/plugin.json manifest (v2.3.0) - Cross-tool compatible: works with any AGENTS.md-based CLI All 4 scripts verified: --help passes, smoke tests run correctly. complexity_checker catches its own nesting depth. assumption_linter correctly flags "just", "obviously", "should work". goal_verifier correctly scores plans with/without verification steps. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>	2026-04-12 13:29:55 +02:00
..
karpathy-gate.sh	feat(engineering): add karpathy-coder — active coding discipline enforcer	2026-04-12 13:29:55 +02:00

Reza Rezvani 17cf7dfc62 feat(engineering): add karpathy-coder — active coding discipline enforcer

Implements Karpathy's 4 coding principles (Think Before Coding, Simplicity
First, Surgical Changes, Goal-Driven Execution) as an active enforcement
plugin, not just passive guidelines. Derived from Karpathy's X post on LLM
coding pitfalls but goes far beyond the source material with automated
detection tools, a review agent, and CI integration patterns.

Differentiator vs forrestchang/andrej-karpathy-skills (prompt-only, single
SKILL.md): this version ships real tooling that DETECTS violations instead
of just documenting principles.

Plugin contents (engineering/karpathy-coder/):
- SKILL.md with `context: fork` for skill chaining
- 4 Python tools (stdlib only):
  - complexity_checker.py — cyclomatic complexity, class density, nesting
    depth, function length, premature abstractions (Principle #2)
  - diff_surgeon.py — diff noise ratio: comment-only changes, whitespace,
    style drift, drive-by refactors, quote-style swaps (Principle #3)
  - assumption_linter.py — detects "just", "obviously", "should work",
    vague actions, unscoped users, missing format specs (Principle #1)
  - goal_verifier.py — scores plan steps 0-3 for verification quality,
    flags vague criteria, checks for final verification (Principle #4)
- 1 sub-agent: karpathy-reviewer (runs all 4 principles against a diff)
- 1 slash command: /karpathy-check (dispatches the reviewer)
- 1 pre-commit hook: karpathy-gate.sh (non-blocking, warns on violations)
- 3 reference docs: karpathy-principles.md (full context + when to relax),
  anti-patterns.md (10+ before/after examples), enforcement-patterns.md
  (Husky, pre-commit framework, GitHub Actions CI integration)
- .claude-plugin/plugin.json manifest (v2.3.0)
- Cross-tool compatible: works with any AGENTS.md-based CLI

All 4 scripts verified: --help passes, smoke tests run correctly.
complexity_checker catches its own nesting depth. assumption_linter
correctly flags "just", "obviously", "should work". goal_verifier
correctly scores plans with/without verification steps.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-12 13:29:55 +02:00

karpathy-gate.sh

feat(engineering): add karpathy-coder — active coding discipline enforcer

2026-04-12 13:29:55 +02:00