Skip to content

docs(readme): list every skill; fix the breakdown; sweep stale references - #17

Merged
StamKavid merged 1 commit into
devfrom
docs/readme-final-audit
Aug 5, 2026
Merged

docs(readme): list every skill; fix the breakdown; sweep stale references#17
StamKavid merged 1 commit into
devfrom
docs/readme-final-audit

Conversation

@StamKavid

Copy link
Copy Markdown
Owner

The README skill tables listed 27 of 29 skills. The two missing were capturing-learnings and — more awkwardly — data-science-project, the front door, the skill this entire rework was about. Named twice in prose, linked from no table.

The prose breakdown also summed to 28: "15 pipeline + 11 domain + 1 methodology + 1 entry" against 29 on disk. Domain is 12.

Two tests now guard these independently, because they drift independently:

  • every skill directory appears in a table, and no table row points at a skill that is gone
  • the breakdown sentence parses and sums to the real count

Staleness sweep

Fixed: eval 6's gate_under_test still named validation-strategy, merged into ds-validate earlier. Removed an empty references/ directory left from an earlier phase.

Left alone, deliberately: the validation-strategy mentions under benchmarks/house-prices/ are the narrative of a completed run — rewriting a finished run's record to match a later refactor would falsify it. The .gitignore entries for venv/ and .last-ds-mile/*.csv match nothing today because they are prospective: they cover files a user's project will produce.

Verified clean

  • 0 dead relative links in README
  • 17/17 commands referenced, all resolve
  • version consistent: plugin.json 0.9.0 · package.json 0.9.0 · marketplace ref v0.9.0
  • 395 tests pass

🤖 Generated with Claude Code

…nces

The README's skill tables listed 27 of 29 skills. The two missing were
capturing-learnings and -- more awkwardly -- data-science-project, the front
door, the skill this whole rework was about. It was named twice in prose and
linked from no table, so a reader browsing the catalogue could not find it.

The prose breakdown also summed to 28: "15 pipeline + 11 domain + 1 methodology
+ 1 entry" against 29 on disk. Domain is 12.

Two tests now guard both independently, because they drift independently: one
asserts every skill directory appears in a table and no table row points at a
skill that is gone, the other parses the breakdown sentence and checks it sums
to the real count.

Swept the rest of the repo for stale references. Fixed: eval 6's
gate_under_test still named validation-strategy, a skill merged into
ds-validate. Removed an empty references/ directory left from an earlier phase.

Deliberately left alone: the validation-strategy mentions in
benchmarks/house-prices/ are the narrative of a completed run, and rewriting a
finished run's record to match a later refactor would falsify it. The
.gitignore entries for venv/ and .last-ds-mile/*.csv match nothing today
because they are prospective -- they cover files a user's project will produce.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@StamKavid
StamKavid merged commit 396d386 into dev Aug 5, 2026
4 checks passed
@StamKavid
StamKavid deleted the docs/readme-final-audit branch August 5, 2026 18:45
StamKavid added a commit that referenced this pull request Aug 8, 2026
docs(readme): list every skill; fix the breakdown; sweep stale references
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant