claude-skills/engineering
Alireza Rezvani 8b0fca4a4d
fix(book-to-skill): correct emitter docstring drift and the resident-core figure
Addresses both review findings on #993.

1. skill_plugin_emitter.py's module docstring still described the behaviour this
   PR removed. Its tree diagram called plugin.json the "manifest with
   ./skills/<slug> + attribution", and the rights-gate paragraph said
   cleared_for_distribution is recorded "in the manifest" -- both now the
   sidecar. A docstring asserting the opposite of its own file's point is worse
   than no docstring, and it is what `--help` readers see.

   Also corrects a third instance the review did not name but which shares the
   root cause: the tree diagram never listed authoring-notes.json at all, even
   though this PR's fix is what creates it. Added, with the issue #954 reason
   stated inline so the next reader knows why provenance cannot live in the
   manifest.

2. CLAUDE.md said the resident core is 2,066 tokens while, twelve lines later,
   the same file said 2,101. 2,066 predates the worked invocation block added
   for write-a-skill checklist item 5; token_budget_estimator.py reports 2,101
   on the current tree, matching CHANGELOG.md and the PR body. CLAUDE.md was
   the only stale copy and it contradicted itself.

Docstring-only and prose-only; no behaviour change. Verified the emitter still
emits both plugin.json and authoring-notes.json via --sample after the edit.

Gates: compileall, check_plugin_json --all, check_paths, check_frontmatter,
check_dual_publish, check_model_freshness, smoke_scripts (696/696),
derive_counters --check, book_skill_validator --strict.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UySnyf5upm4y8xhYA3w6yw
2026-08-25 22:57:41 +00:00
..
.claude-plugin feat(skills): wave-3 optimization — domain overhauls per newgen audit 2026-06-11 03:58:41 +00:00
.codex feat(skills): wave-3 optimization — domain overhauls per newgen audit 2026-06-11 03:58:41 +00:00
agent-harness fix: rename all remaining built-in-shadowing skill names and harden the last cp1252-fatal scripts (#885, #969 follow-through) 2026-08-21 08:38:50 +00:00
agent-memory fix(agent-memory): address automated review; harden the session-id fallback 2026-08-24 18:45:52 +00:00
agenthub fix: rename all remaining built-in-shadowing skill names and harden the last cp1252-fatal scripts (#885, #969 follow-through) 2026-08-21 08:38:50 +00:00
autoresearch-agent Merge pull request #973 from alirezarezvani/claude/review-15-reported-issues-vrt6b2 2026-08-21 10:44:01 +02:00
behuman chore(versioning,docs): normalize stale versions to 2.9.0 + refresh counts 2026-05-27 05:22:59 +00:00
book-to-skill fix(book-to-skill): correct emitter docstring drift and the resident-core figure 2026-08-25 22:57:41 +00:00
boost-asio-pro feat(engineering): add boost-asio-pro skill for async C++ networking 2026-08-18 16:50:46 +02:00
caveman fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885) 2026-08-21 05:47:37 +00:00
chaos-engineering feat(tooling): JSON-output sample gate (G9) + --sample fixtures (#654) 2026-06-11 15:29:39 +00:00
claude-coach feat(tooling): JSON-output sample gate (G9) + --sample fixtures (#654) 2026-06-11 15:29:39 +00:00
code-tour chore(versioning,docs): normalize stale versions to 2.9.0 + refresh counts 2026-05-27 05:22:59 +00:00
collab-proof fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885) 2026-08-21 05:47:37 +00:00
data-quality-auditor feat(skills): wave-3 optimization — domain overhauls per newgen audit 2026-06-11 03:58:41 +00:00
deep-learning-book fix(deep-learning-book): reject overlapping capacity regime bands 2026-08-25 20:06:05 +00:00
demo-video chore(versioning,docs): normalize stale versions to 2.9.0 + refresh counts 2026-05-27 05:22:59 +00:00
docker-development chore(versioning,docs): normalize stale versions to 2.9.0 + refresh counts 2026-05-27 05:22:59 +00:00
feature-flags-architect chore(versioning,docs): normalize stale versions to 2.9.0 + refresh counts 2026-05-27 05:22:59 +00:00
grill-me fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885) 2026-08-21 05:47:37 +00:00
grill-with-docs fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885) 2026-08-21 05:47:37 +00:00
handoff fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885) 2026-08-21 05:47:37 +00:00
helm-chart-builder chore(versioning,docs): normalize stale versions to 2.9.0 + refresh counts 2026-05-27 05:22:59 +00:00
hivemind fix(hivemind): justify child_process imports for the security audit gate 2026-08-24 20:36:41 +00:00
human-gate merge dev into human-gate branch: resolve counter surfaces, move attribution to authoring-notes.json sidecar (issue #954 policy), true up counters to 371/675/812/93 2026-08-21 09:04:37 +00:00
karpathy-coder fix: phantom-path sweep — 888 unresolvable references to zero 2026-06-10 14:33:00 +00:00
kubernetes-operator chore(versioning,docs): normalize stale versions to 2.9.0 + refresh counts 2026-05-27 05:22:59 +00:00
llm-cost-optimizer fix(models): remove retired model IDs and stale pricing, flip G7 blocking 2026-08-03 08:55:36 +08:00
llm-wiki fix: phantom-path sweep — 888 unresolvable references to zero 2026-06-10 14:33:00 +00:00
memory-engineering fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885) 2026-08-21 05:47:37 +00:00
minimalist feat(engineering): add minimalist and strict-api skills 2026-07-06 13:05:12 +05:30
prompt-governance fix(models): remove retired model IDs and stale pricing, flip G7 blocking 2026-08-03 08:55:36 +08:00
security-guidance fix(stream): post-merge required changes for PRs #895/#926/#942/#943/#944/#965 + counter true-up + #964 guard + #954 doc drift 2026-08-21 09:01:24 +00:00
skill-doctor fix(skill-doctor): address automated review — repo-match transparency, exact-id error dedup 2026-08-24 20:03:06 +00:00
skillopt-sleep fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885) 2026-08-21 05:47:37 +00:00
skills Merge pull request #973 from alirezarezvani/claude/review-15-reported-issues-vrt6b2 2026-08-21 10:44:01 +02:00
slo-architect feat(tooling): JSON-output sample gate (G9) + --sample fixtures (#654) 2026-06-11 15:29:39 +00:00
spinning-up-deep-rl docs(book-to-skill): add attribution block to the compiled skill's sidecar 2026-08-25 18:57:31 +00:00
statistical-analyst chore(versioning,docs): normalize stale versions to 2.9.0 + refresh counts 2026-05-27 05:22:59 +00:00
strict-api feat(engineering): add minimalist and strict-api skills 2026-07-06 13:05:12 +05:30
terraform-patterns chore(versioning,docs): normalize stale versions to 2.9.0 + refresh counts 2026-05-27 05:22:59 +00:00
universal-scraping-architect fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885) 2026-08-21 05:47:37 +00:00
workflow-builder fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885) 2026-08-21 05:47:37 +00:00
write-a-skill fix(stream): post-merge required changes for PRs #895/#926/#942/#943/#944/#965 + counter true-up + #964 guard + #954 doc drift 2026-08-21 09:01:24 +00:00
zero-hallucination-coder fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885) 2026-08-21 05:47:37 +00:00