Skip to content

docs: express headline skill count as a stable 60+ floor - #859

Merged
aaronjmars merged 1 commit into
mainfrom
docs/skill-count-floor
Aug 5, 2026
Merged

aaronjmars merged 1 commit into
mainfrom
docs/skill-count-floor

Conversation

@aaronjmars

Copy link
Copy Markdown
Collaborator

Makes the headline skill total a stable 60+ floor on the surfaces CI does not guard, so a new skill no longer silently leaves them stale (and docs-sync stops chasing the exact digit across six files every batch).

Changed to 60+ (CI-unguarded — these are the ones that silently rot)

  • .github/README.md: hero alt-text + packs-banner alt-text.
  • docs/assets/hero-animated.svg: the hero art 68 skills text.
  • docs/skill-packs.md intro, docs/aeon-setup.md, docs/examples/README.md prose.

Left EXACT on purpose (CI-guarded → can't rot)

scripts/validate-readme-catalog.mjs already diffs these against catalog/packs.json on every PR:

  • README full-catalog caption all N skills by pack + its anchor ↔ docs/skill-packs.md heading.
  • The summary + full-catalog per-pack tables and all per-category counts (Core 12, Evolution 9, ...).

Website React counts are untouched (they self-update via getSkillCount()/ISR). No behavior change; docs only.

CI-unguarded marketing/prose surfaces (hero + packs alt-text, hero SVG art,
docs prose intros) no longer hardcode the exact skill total, so a new skill
does not silently leave them stale. The CI-guarded full-catalog caption, the
per-pack tables, and per-category counts stay exact - validate-readme-catalog.mjs
keeps those honest on every skill add.
@aaronjmars
aaronjmars merged commit 8ffcb57 into main Aug 5, 2026
2 checks passed
@aaronjmars aaronjmars mentioned this pull request Aug 24, 2026
4 tasks done
@aaronjmars
aaronjmars deleted the docs/skill-count-floor branch August 26, 2026 14:41
aaronjmars added a commit that referenced this pull request Sep 24, 2026
* docs: refresh stale README stats and fix dead README links

README:
- Proof of work: 4.7M stars secured across 100+ repos, 70+ products,
  15+ community packs (was 2M / 69 / 68 / 13). Floors follow the #859
  idiom for CI-unguarded prose.
- digest example frontmatter now matches the real nested metadata: shape.
- Scoring line: a cheap model rates every run (Haiku on Claude); grok and
  other harnesses score with their own model.
- Quick start alt text lists Slack alongside Telegram, Discord, email.

Dead links into .github/README.md (sections moved out long ago):
- community-packs / community-skill-packs -> docs/community-skill-packs.md#listed-packs
  (CONTRIBUTING.md, ADK.md, ECOSYSTEM.md x2)
- authentication -> CONFIGURATION.md#authentication
- mcp-servers-in-skill-runs -> CONFIGURATION.md#mcp-servers-in-skill-runs
- harnesses -> current nine-harness README heading; harnesses.md intro no
  longer says "two first-class harnesses" and lists cursor + hermes.

* docs: refresh Proof of work banner to 4.7M / 70+ / 15+

---------

Co-authored-by: aaronjmars <aaronjmars@users.noreply.github.com>
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