scriptoriumadmin/claude-skills
1
0
Fork 0
mirror of https://github.com/alirezarezvani/claude-skills.git synced 2026-09-07 08:26:02 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
1506 commits 6 branches 7 tags 43 MiB
Commit graph

41 commits

Author SHA1 Message Date
Claude
d928ec95d5
release: v2.12.0 — consolidated release notes, version bump, docs-site regeneration 
- CHANGELOG.md gains the [2.12.0] entry (first tagged release since v2.9.0):
  consolidates the previously documented but untagged v2.10.0-v2.11.2 work,
  all post-2.11.2 merges, and the full 17-issue triage sweep; the ten stacked
  [Unreleased] sections are demoted into the 2.12.0 body so the Release
  workflow tags and publishes the whole span. Verified parseable with
  scripts/extract_release_notes.py (version 2.12.0, 554-line body).
- Version markers bumped to 2.12.0: marketplace.json metadata,
  CLAUDE.md current-version header + footer.
- Counters trued to the derived values (380 skills / 96 plugins / 20 domains /
  706 tools / 823 refs / 114 agents / 138 commands) in README badges + prose,
  CLAUDE.md, marketplace.json, and the long-stale mkdocs.yml/docs/index.md
  site description (was still claiming 345/78/17).
- Docs site regenerated via scripts/generate-docs.py (568 generated pages;
  new pages for the recently merged plugins); codex/gemini mirrors resynced;
  mkdocs build verified locally with the same plugin set static.yml uses
  (670 HTML pages, no errors).
- Fix: the three hivemind worker personas (assets/agents/{coder,scout,tester}.md,
  merged via #979 while Actions was not triggering) lacked the frontmatter
  `name:` field and hard-failed the blocking G10 gate — named
  hive-coder/hive-scout/hive-tester; 645 files now scan with 0 errors.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Qgc6RYXWJPr5oW9DHU7zR4
 2026-08-24 20:35:06 +00:00
Claude
abd9c9d8de
docs(site): generate agent-launcher pages (18th domain) + nav 
generate-docs.py learns the agent-launcher domain (5 hardcoded maps extended);
regenerated docs tree: 343 skill pages / 96 agent pages / 122 command pages
(561 total). mkdocs.yml nav gains the Agent Launcher skill section (7 pages),
4 cs-agent-* agent entries, and 8 /cs:* command entries; all nav targets verified
to exist.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012FwXG6TqCXKZQvF4iD69cv
 2026-08-24 17:26:12 +00:00
Claude
a80eec2267
fix: rename all remaining built-in-shadowing skill names and harden the last cp1252-fatal scripts (#885, #969 follow-through) 
Round-2 sweep after re-auditing all 15 reported issues against the merged dev:

- #885 generalized: the original fix only renamed self-improving-agent's
  status/review, but three more plugins shipped skills whose bare names
  shadow Claude Code built-ins. Renamed with the same convention:
  playwright-pro init/review -> pw-init/pw-review, agenthub init/status ->
  hub-init/hub-status, autoresearch-agent status/resume -> ar-status/
  ar-resume. All command references (/pw: /hub: /ar:), docs, audit records,
  harness manifests, and mirror trees/indexes updated; the flat mirror
  namespace no longer collides on 'status'. New scripts/check_skill_names.py
  gate (wired into ci-quality-gate.yml as blocking) fails CI on any future
  bare reserved name; rule added to SKILL-AUTHORING-STANDARD.md.
- #969 follow-through: five more scripts print box-drawing characters that
  cannot exist in cp1252 (api_scorecard, api_linter,
  breaking_change_detector, humanizer_scorer, content_scorer) — same
  guarded UTF-8 reconfigure applied; all smoke-tested under a forced
  legacy encoding.

Verified: check_skill_names (incl. negative test), check_plugin_json,
check_paths, derive_counters, check_dual_publish, smoke_scripts (634/634),
0 broken mirror symlinks.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Qgc6RYXWJPr5oW9DHU7zR4
 2026-08-21 08:38:50 +00:00
Claude
667cb3207b
docs: regenerate catalog pages for skills updated in PRs #843/#844 
mcp-server-builder, performance-profiler, ci-cd-pipeline-builder, and four
ra-qm-team skill sources changed after the last docs regeneration; refresh
their generated pages so the published site matches the SKILL.md sources.

https://claude.ai/code/session_015bYZ97nV4oRb3LbxCRFVcP
 2026-06-12 05:58:43 +00:00
Claude
82c5aea9f0
Merge origin/dev: reconcile docs redesign with upstream skill changes 
- Resolve conflicts: keep redesigned skills index, take dev's cs-aeo link
  fix, union of DOMAIN_SEO_CONTEXT entries in generate-docs.py
- Regenerate catalog on the merged tree (dev's agent/command description
  updates, removed ai-seo/release-manager/command-guide, restructured
  universal-scraping-architect)
- Update counters to post-merge truth from scripts/derive_counters.py:
  345 skills, 78 plugins (14 bundles + 64 standalone), 570+ Python tools
- Add redirects for upstream-removed pages (ai-seo -> aeo,
  release-manager -> changelog-generator, command-guide -> engineering index)
- Add compliance-os bundle to bundle tables; rebuild 78-plugin table from
  marketplace.json
- Teach the generator to rewrite repo-root-relative source links to GitHub
  URLs — mkdocs build --strict now passes with zero warnings

https://claude.ai/code/session_015bYZ97nV4oRb3LbxCRFVcP
 2026-06-11 15:52:42 +00:00
Claude
0a330f3759
feat(docs): redesign documentation site — clay design system, accurate counters, markdown-html domain pages 
- Rewrite docs/stylesheets/extra.css with a warm clay/coral design system:
  aurora hero with eyebrow badge and stats strip, gradient card hairlines,
  pill tool badges, numbered steps component, reduced-motion support
- Rewrite homepage copy: plain-language 'What is an Agent Skill?' section,
  3-step how-it-works, all 17 domain cards, guides section, accurate stats
  (337 skills / 17 domains / 66 plugins)
- Add missing markdown-html domain to generate-docs.py (17th domain) and
  regenerate catalog: +12 new pages (md-document/md-review/md-slides skills,
  cs-markdown-html-orchestrator + cs-scraping-architect agents, 7 commands)
- Fix skill-internal link rewriting in the generator (./SIBLING.md and
  ALL-CAPS companion files now resolve to GitHub URLs) — mkdocs --strict
  now passes with zero warnings
- Refresh stale counters site-wide (177/192/204/311/338 → 337) in skills
  index, plugins index, getting-started, integrations, custom-gpts, guides
- Rebuild plugins page from live marketplace.json: 13 domain bundles + 53
  standalone plugins, accurate bundle table and full 66-plugin listing
- Add Guides section to nav (5 existing SEO guide pages, URLs unchanged),
  point homepage tool badges at tool-specific guides and real anchors
- Tighten site_description and JSON-LD keywords for 'agent skills' /
  'agent plugins' queries; update announce bar to the markdown-html launch
- No existing slugs or URLs changed — all edits are additive or in-place

https://claude.ai/code/session_015bYZ97nV4oRb3LbxCRFVcP
 2026-06-11 15:45:00 +00:00
Claude
645453278a
chore(registry,docs): reconcile counters, prune deleted-skill refs, resync trees 
- counters trued to derived values (344 skills / 579 tools / 698 references)
  in README.md + marketplace.json; derive_counters --check passes
- marketplace descriptions fixed: marketing-skills (8 pods, real tool counts),
  engineering-advanced-skills (37 actual skills, mirrors plugin.json)
- deleted-skill references pruned from README, mkdocs nav, docs pages,
  cs-senior-engineer docs page
- .codex/.gemini/.hermes/.vibe sync trees regenerated; dangling symlinks for
  ai-seo/release-manager removed

https://claude.ai/code/session_019AJddAL1NADWMXsy1qNPQF
 2026-06-11 03:58:42 +00:00
Claude
0beccad00b
docs(workflow-builder): add MkDocs pages + nav for the skill 
Generate GitHub Pages for the workflow-builder skill, its cs-workflow-architect
agent, and the /cs:workflow-build command (via generate-docs.py), and wire all
three into mkdocs.yml nav (Engineering - POWERFUL, Agents, Commands sections).
Updated section index pages. Build verified clean (551 pages).

Aggregate skill counts unchanged — workflow-builder was already included in
dev's 338-skill / engineering-advanced-78 header.

https://claude.ai/code/session_01Q1kXbgMRodzhdTpgbCqVgx
 2026-05-27 14:54:08 +00:00
Claude
7db491054b
docs: full repo doc resync (v2.9.0) — wire research-ops + compliance-os into docs site 
Ran the /update-docs post-creation pipeline across the whole repo.

Docs site (MkDocs):
- generate-docs.py now covers 16 domains (added research-ops at order 15
  and compliance-os at order 16 + its embedded-agent mapping). Regenerated
  500 pages (328 skills + 89 agents + 83 commands); build passes.
- mkdocs.yml: site_description refreshed to 338/16/51+/87+ + v2.9.0; added
  the Research Operations and Compliance OS skills nav sections, the
  cs-research-ops-orchestrator + 8 compliance-os agents, and the 6
  research-ops command entries.
- docs/index.md: title, description, hero, the five "What's Inside" cards
  (338 skills, 51+ agents, 533 tools, 62 plugins, 87+ commands), corrected
  six domain-card counts, and added a Research Operations domain card.
- docs/getting-started.md: description, Vibe count, FAQ, bundles table
  (six corrected counts) + a research-ops bundle row.

Cross-platform sync (all four scripts gained a compliance-os entry):
- Codex: compliance-os 9 skills symlinked + index; unrelated run/status/
  review symlink churn reverted to keep the diff focused.
- Gemini: 9 compliance-os SKILL.md mirrors + index.
- Vibe (repo target): 9 compliance-os symlinks + index.
- Hermes/Vibe domain lists updated for future syncs.

compliance-os was a tracked 9-skill domain previously absent from the docs
site and the codex/gemini/vibe indices; it is now fully wired in.

The MkDocs `site/` build output is gitignored and excluded.

https://claude.ai/code/session_01PUNmQVE4WYvcrzpq2anC3D
 2026-05-27 06:32:03 +00:00
Claude
2c09797115
docs(andreessen): run update-docs sync pipeline + mkdocs nav for v2.8.3 
- Bump headline counts: 329 -> 330 skills, ~448 -> ~451 tools, ~586 -> ~590
  references, 49+ -> 50+ agents, 79+ -> 81+ commands across CLAUDE.md, README,
  docs/index.md, docs/getting-started.md, mkdocs.yml.
- README productivity row 5 -> 6; add andreessen entry.
- CLAUDE.md: v2.8.3 highlights section + version/status/date footer.
- marketplace.json metadata + top-level description counts incremented.
- mkdocs.yml nav: add andreessen skill page, cs-andreessen agent,
  /cs:andreessen + /cs:pmf-check commands.
- Regenerate docs pages via generate-docs.py (andreessen skill/agent/commands;
  also reconciles claude-coach pages + dev-drift on code-reviewer/role-skill pages).
- mkdocs build verified clean (only pre-existing unrelated relative-link warnings).

https://claude.ai/code/session_01SF6MzfjHurZMt5JUFET9h3
 2026-05-24 01:52:12 +00:00
Claude
7c54a72d94
chore(v2.7.3): release prep — docs sync + audit fixes + CHANGELOG 
Post-merge sync of v2.7.3 (#679 already in dev). Three things in one
commit:

## 1. /update-docs pipeline (Steps 1-7)

Cross-platform sync verified clean across 3 platforms (.codex 305 /
.gemini 355 / .hermes 305 — aeo + security-guidance present in all
three indexes). 401 → 403 MkDocs pages generated.

**Files refreshed to v2.7.3 / 313 / 46+ / 60+ counts:**

- `.claude-plugin/marketplace.json` — top-level description + metadata
  description + metadata.version (was 2.7.0).
- `CLAUDE.md` — Current Scope line, new v2.7.3 Highlights section,
  footer (Last Updated + Version + Status).
- `README.md` — tagline, badges, Skills Overview row counts (Engineering
  POWERFUL 44 → 45, Marketing 44 → 45 w/ 8 pods), Python Tools count,
  FAQ counts. Hermes footnote ticked v2.7.2 → v2.7.3.
- `docs/index.md` — title, meta description, hero subtitle, grid card.
- `docs/getting-started.md` — meta description, FAQ count.
- `mkdocs.yml` — site_description + 3 nav entries (skill + agent + cmd).
- `marketing-skill/.claude-plugin/plugin.json` — 44 → 45 skills, 7 → 8
  pods, v2.2.3 → v2.7.3.
- `marketing-skill/CLAUDE.md` — 43 → 45 skill count, 32 → 58 Python
  tools, 7 → 8 pods. Added AEO skill to skill map.

## 2. /plugin-audit on both new skills (full 8-phase pipeline)

**aeo (marketing-skill/skills/aeo/)** — PASS WITH WARNINGS:
- Phase 2 Structure: 86.4/GOOD (after auto-fix of YAML frontmatter
  parse error — colon in description value needed quote-wrapping)
- Phase 3 Quality: 52.4/D (validator expects legacy fields v2.7 skills
  don't use — repo-wide pattern, not a defect)
- Phase 4 Scripts: 3/3 PASS
- Phase 5 Security: 2 HIGH NET-EXFIL findings on urllib.request — same
  known false-positive as sister seo-audit skill (URL fetch is core
  functionality for content-audit-by-URL tools, not exfiltration)
- Phase 6 Marketplace: plugin.json valid (v2.7.3, all required fields)
- Phase 7 Ecosystem: indexed in all 3 platforms
- Phase 8 Code Review: 22 workflow sections, refs cite 8/17/37 sources
  (≥7 floor met), 0 broken links, attribution present

**security-guidance (engineering/security-guidance/)** — PASS WITH
WARNINGS:
- Phase 2/3/4: low scores due to hook-plugin layout mismatch with
  script-plugin validators (hook plugins use `hooks/` not `scripts/`
  per Claude Code spec — fundamental structural mismatch, not a defect)
- Phase 5: 6 CRITICAL + 4 HIGH findings are all recursive false-
  positives — auditor detects the hook's OWN pattern-detection strings
  (`"exec("`, `"eval("`, `"yaml.load("` are substring literals used as
  detection rules, NOT actual calls). Verified zero real exec/eval
  calls in the file.
- Phase 6/7: clean (plugin.json valid, hooks.json valid, indexed in
  all 3 platforms, mkdocs nav entry added)
- Phase 8: 291 LOC, syntax valid, clear exit-code contract (0=clean,
  2=block per Claude Code hook spec), session-state caching @ lines
  158-191, 30-day cleanup @ line 163, attribution full, live smoke
  test (`eval(input())` in Write → exit 2 + warning) PASS
- **Real defects: 0.**

## 3. Layout fix (Phase 7 audit catch)

The /plugin-audit Phase 7 caught a real layout bug: cs-aeo.md placed
at `marketing-skill/agents/cs-aeo.md` and `marketing-skill/commands/
cs-aeo.md` was unreachable by `scripts/generate-docs.py` (which only
walks root `agents/<domain>/` and root `commands/`). Result: docs/
pages for cs-aeo agent + /cs:aeo command were never generated.

**Moved to repo-canonical locations:**
- `marketing-skill/agents/cs-aeo.md` → `agents/marketing/cs-aeo.md`
- `marketing-skill/commands/cs-aeo.md` → `commands/cs-aeo.md`

Cleaned empty `marketing-skill/agents/` + `marketing-skill/commands/`
directories. Re-ran `scripts/generate-docs.py`: 401 → 403 pages
(73 agents + 34 commands — both new entries present).

## CHANGELOG.md

Added [2.7.3] - 2026-05-17 entry with full Added / Changed / Layout
fix / Cross-platform sync / Honest audit results / PRs / Verification
sections. Audit results documented verbatim including the known
false-positives — no claims of clean security where the auditor flagged
patterns it can't disambiguate.

https://claude.ai/code/session_01FEUmeuYhmnxVFq7EZM8ZSw
 2026-05-17 07:44:02 +00:00
Claude
637210b340
docs(v2.7.0): MkDocs + GitHub Pages + cross-platform CLI sync update 
Comprehensive documentation sync for v2.7.0 across all surfaces.

**Files updated:**

Documentation:
- CLAUDE.md: Current Scope line (272 → 311 skills, 9 → 12 domains,
  v2.7.0 Path-B additions noted)
- README.md: hero count + badge counts + Skills Overview table (3 new
  domain rows: Productivity, Marketing top-level, Research)
- docs/index.md: hero + grid cards + meta description (311 skills, 12
  domains, v2.7.0 Path-B additions)
- docs/getting-started.md: meta description + FAQ counts
- mkdocs.yml: site_description + nav (3 new domain sections with 13
  new skill pages)
- .claude-plugin/marketplace.json: top-level description + metadata
  bumped 2.6.1 → 2.7.0

Cross-platform sync (Step 2 of the post-creation pipeline):
- .codex/skills-index.json: 290 → 303 entries
- .gemini/skills-index.json: 351 → 353 items (grill-with-docs added)
- Codex script (scripts/sync-codex-skills.py): SKILL_DOMAINS extended
  with productivity/marketing/research top-level folders (committed in
  PR #673 — verified working in this sync)

Generator extension:
- scripts/generate-docs.py: DOMAINS dict extended with productivity,
  marketing, research entries (with SEO suffix + description context).
  Generator now emits 294 skill pages across 12 domains (was 281
  across 9). Total pages: 399 (was 373).

Generated doc pages (21 new):
- docs/skills/productivity/{capture, email-inbox-setup,
  email-inbox-triage, reflect, index}.md
- docs/skills/marketing/{landing, index}.md
- docs/skills/research/{research, pulse, litreview, grants, dossier,
  patent, syllabus, notebooklm, index}.md
- docs/agents/{cs-capture, cs-grants, cs-litreview, cs-dossier,
  cs-pulse, cs-patent, cs-syllabus, cs-notebooklm, cs-research,
  cs-reflect, cs-landing, cs-inbox-setup, cs-inbox-triage,
  cs-grill-with-docs}.md

Verification:
- MkDocs build: PASSED (16.03s, 448 HTML pages generated)
- Consistency check: all 5 core doc files now reference 311 skills
- Path validation: all 55 marketplace.json source paths valid
- Frontmatter check: 13/13 new SKILL.md files have valid YAML

Known minor: 3 unrelated pre-existing duplicate-path symlinks
(review/run/status) flipped target during codex sync. These are skill
name collisions across multiple folders; sync script now picks one
consistent canonical path. Same churn would happen on any sync run.

https://claude.ai/code/session_01FEUmeuYhmnxVFq7EZM8ZSw
 2026-05-16 11:57:12 +00:00
Claude
9975cc9f9b
chore(update-docs): post-v2.6.1 sync sweep + Codex sync bug fix 
Ran the /update-docs pipeline post-v2.6.1 release. Most of the work was
verification (docs already in sync from prior PRs #644, #649). Two real
issues surfaced and fixed:

1. Codex sync bug (the headline fix)
- scripts/sync-codex-skills.py used iterdir() which is single-level only
- Missed the engineering/<plugin>/skills/<name>/SKILL.md pattern used by
  4 Pocock plugins + many other standalone plugins restructured since
  PR #593
- Added Pattern 3 discovery: when <domain>/<plugin>/ contains a skills/
  subdir with <name>/SKILL.md, recurse one level
- Impact: Codex index 195 → 289 skills (+94 previously-hidden skills)
- Gemini sync was already correct (uses recursive rglob)
- OpenClaw was already correct (uses recursive find)

2. Stale skill counts in 2 user-facing docs
- README.md: 268 → 272 (3 occurrences: tagline + badge + skills overview)
- docs/getting-started.md: 246 → 272 (2 occurrences: meta description + FAQ)
- All other files (CLAUDE.md, docs/index.md, mkdocs.yml site_description,
  marketplace.json) were already at 272 (refreshed in PRs #644 + #649)

Other regenerations (no source changes — auto-updated from latest content):
- docs/skills/engineering/*.md regenerated (picks up v2.6.1 description fixes)
- docs/agents/*.md regenerated (no agent changes)
- docs/commands/*.md regenerated (no command changes)
- .codex/skills-index.json + 94 new symlinks (mostly Pocock + plugin-pattern
  skills that should have been there since PR #593)

Verification:
- All 5 user-facing docs (CLAUDE.md, README.md, docs/index.md,
  docs/getting-started.md, mkdocs.yml) show "272 skills" consistently
- marketplace.json: v2.6.1, 43 plugins, 0 broken source paths
- mkdocs build: 371 pages (280 skills + 58 agents + 33 commands), clean
  in 17.31s, no errors or new warnings
- audit_skills.py: runs cleanly against 298 real skills

No production code changes outside the Codex sync fix. This is a docs +
tooling sweep, not a feature release.

https://claude.ai/code/session_01VFreMf7XLBqMgjsrG4wSYe
 2026-05-14 10:41:52 +00:00
Claude
cc8ff7c2d6
docs(v2.6.0): add Pocock skills/agents to docs site + refresh stale counts 
Adds the 4 new Matt Pocock-derived skills + 4 cs-* agent pages to the
github.io docs site (Material for MkDocs). Refreshes stale skill counts
across index.md + mkdocs.yml site_description.

Auto-generated via scripts/generate-docs.py (the established generator
that v2.5.7 fixed the dedup bug in):

New skill pages (docs/skills/engineering/):
- caveman.md
- grill-me.md
- handoff.md
- write-a-skill.md

New agent pages (docs/agents/):
- cs-caveman-mode.md
- cs-grill-master.md
- cs-handoff-author.md
- cs-skill-author.md

mkdocs.yml nav additions:
- Engineering POWERFUL section: 4 new entries after Ship Gate, labeled
  "(Matt Pocock-derived)" for clear attribution
- Agents section: 4 new entries after CS VPE Advisor, same labeling
- site_description: 268 → 272 skills; 33 → 37 cs-* agents; 21 → 25 /cs:*
  commands; explicit Pocock quartet callout

docs/index.md refresh:
- title: 246 → 272 Agent Skills
- description: refreshed with v2.6.0 Pocock-quartet callout
- hero subtitle: 246 → 272 skills; 20 → 37 cs-* agents
- "What's Inside" cards: 246 → 272 Skills; 20 → 37 Agents

Side-effect (additive only, non-blocking):
- 2 pre-existing ra-qm-team skills (EU AI Act Specialist + ISO 42001
  Specialist) finally generated their canonical docs pages (they had
  SKILL.md files but no docs/ entries). The long-named dual-publish
  duplicates were removed to avoid the v2.5.7 dedup regression.

Build verified: 412 HTML pages generated in 18.17s (was 357 in v2.5.7).
All 4 new skill pages + 4 new agent pages present in build output.
No new warnings from our additions (only generic Material for MkDocs
2.0 upgrade notice that pre-dates this PR).

https://claude.ai/code/session_01VFreMf7XLBqMgjsrG4wSYe
 2026-05-13 22:28:51 +00:00
Claude
6524d93478
fix(docs): render orphan sub-skills (recover 79 missing skill pages) 
generate-docs.py had a longstanding bug: the rendering loop only iterated
top-level skills and only rendered their direct children. Sub-skills whose
parent is a plugin folder (not a top-level skill at <domain>/skills/<name>/)
were silently dropped.

Affected plugins (standalone-only, no bundled mirror at <domain>/skills/):
- executive-mentor (1 index + 5 sub-skills)
- agenthub (1 index + 7 sub-skills)
- autoresearch-agent (1 index + 5 sub-skills)
- playwright-pro (1 index + 9 sub-skills)
- self-improving-agent (1 index + 5 sub-skills)
- c-level-agents (1 index + 17 sub-skills — the new /cs:* commands)
- llm-wiki (1 index + sub-skills)
- behuman, code-tour, demo-video, helm-chart-builder, karpathy-coder,
  llm-cost-optimizer, prompt-governance, statistical-analyst, terraform-patterns,
  data-quality-auditor, docker-development (single-skill plugins)

Total: 79 sub-skills + 12 plugin-index skills = 91 pages were being dropped.
(Some plugins like behuman are single-skill so only their index is dropped.)

The bug: rendering loop at line 414 only handled `for skill in top_level`,
then for each top-level found `children = [s for s in sub_skills if
s["parent"] == skill["name"]]`. Plugins where the SKILL.md lives only at
<plugin>/skills/<plugin>/SKILL.md don't appear in top_level (their detection
puts them in sub_skills with parent=themselves), so their children were
orphaned.

The fix: after the existing top-level loop, render orphan sub-skills grouped
by their plugin parent. Index sub-skill (named same as parent) renders as
<parent>.md; other children render as <parent>-<child>.md. This matches the
URL convention already in use (e.g., executive-mentor-challenge.md), so
existing SEO equity is preserved.

Result: skill pages generated 193 → 272 (+79 recovered). Total docs pages
280 → 359. mkdocs build succeeds.

Verified:
- All 12 previously-dropped plugins render their index page
- All 79 previously-dropped sub-skills render their detail pages
- URL convention preserved (executive-mentor-challenge.md, agenthub-board.md,
  playwright-pro-coverage.md, etc.)
- karpathy diff_surgeon: 0 findings

After dev → main release: GitHub Pages redeploys with the recovered 79 pages.
The docs site finally has 1:1 correspondence between SKILL.md files in the
repo and pages on the site.

https://claude.ai/code/session_012WtZMm5NJHqkYoRqA9fHMN
 2026-05-13 12:49:00 +00:00
Claude
9d9513236b
docs(site): refresh nav, fix dual-publish dedup, add 301 redirects (v2.5.7) 
User-requested docs refresh ahead of dev->main release. Critical SEO concern:
preserve all existing Google SERP indexes; add 301-equivalent redirects for
any deleted page.

generate-docs.py dedup fix:
The auto-generator created BOTH <name>.md (bundled) AND <name>-<name>.md
(standalone wrapper) for dual-published skills, producing duplicate-content
pages. Updated find_skill_files() to detect the dual-publish pattern
(<domain>/<name>/skills/<same-name>/SKILL.md paired with
<domain>/skills/<name>/SKILL.md) and skip the standalone mirror in favor of
the bundled (canonical) version.

mkdocs-redirects plugin added:
Added to mkdocs.yml plugins. Provides client-side meta-refresh + JS fallback
that preserves URL anchors. Google's SERP indexing treats meta-refresh with
delay=0 as 301-equivalent.

4 pre-existing engineering dual-publish dupe pages deleted with redirects:
- chaos-engineering-chaos-engineering.md -> chaos-engineering.md
- feature-flags-architect-feature-flags-architect.md -> feature-flags-architect.md
- kubernetes-operator-kubernetes-operator.md -> kubernetes-operator.md
- slo-architect-slo-architect.md -> slo-architect.md

Verified: redirect HTML correctly emitted with <meta http-equiv="refresh"
content="0; url=../canonical/"> + JS fallback. Existing Google SERP indexes
preserved.

mkdocs.yml nav additions:
- 5 new C-role docs pages (General Counsel, CDO, CAIO, CCO, VPE)
- 13 new cs-* agent docs pages (cs-cfo / cs-cmo / cs-cro / cs-cpo / cs-coo /
  cs-chro / cs-ciso / cs-chief-of-staff / cs-general-counsel / cs-cdo / cs-caio
  / cs-cco / cs-vpe)

site_description updated:
"246 skills, 20 cs-* agents" (6 versions stale) -> "268 skills, 33 cs-* agents
(incl. founder-mode C-suite), 21 /cs:* slash commands, and an orchestration
protocol for 12 AI coding tools."

README.md counts refreshed:
- 246 -> 268 skills
- 20 -> 33 agents
- 33 -> 54 commands
- 359 -> 373 Python tools
- subtitle expanded with founder-mode lineup callout

.github/workflows/static.yml:
Updated install step from `pip install mkdocs-material` to
`pip install mkdocs-material mkdocs-redirects`.

71 pre-existing skill pages preserved (no SEO equity loss). 5 new pages added,
4 dupes deleted with redirects. mkdocs build verified successful (357 HTML
pages). karpathy diff_surgeon: 0 findings. CHANGELOG entry as v2.5.7.

13 INFO-level link warnings exist from before this session (pre-existing
broken anchors and relative-link-without-index hints) — not introduced by
this PR; tracked separately.

https://claude.ai/code/session_012WtZMm5NJHqkYoRqA9fHMN
 2026-05-13 07:44:28 +00:00
Claude
c9dcd25f8c
docs(generated): regenerate 192 skill + 29 agent + 33 command pages 
Auto-regenerated by scripts/generate-docs.py after the post-restructure
fix. Covers slo-architect, ship-gate, chaos-engineering, kubernetes-operator,
feature-flags-architect, llm-wiki, tc-tracker, and 185 other skills now
properly surfaced under their domain index pages.
 2026-05-10 07:21:13 +00:00
Alireza Rezvani
9dd6fd184c
feat(slo-architect): Phase 4 — SLO/SLI/error-budget discipline (#605) 
Phase 4 of the multi-skill build effort. Same 14-step pipeline.

## What landed

### New skill: engineering/slo-architect

End-to-end SLO discipline per Google SRE Workbook. Published as BOTH:
- Standalone plugin: engineering/slo-architect/
- Bundled mirror:    engineering/skills/slo-architect/

3 stdlib-only Python tools (Karpathy complexity 95/100):
- slo_designer.py             — generates SLO definitions; refuses to render
                                 if required fields missing (owner, policy doc,
                                 SLI numerator/denominator). Supports 5 SLI
                                 types: request-success-rate, request-latency,
                                 availability-time, data-freshness, correctness.
- error_budget_calculator.py  — computes error budget AND the canonical
                                 multi-window burn-rate alert thresholds:
                                 fast (1h/5m, page), slow (6h/30m, page),
                                 ticket (3d/6h). Output is PromQL-shaped,
                                 ready to paste into Prometheus rules.
- slo_review.py               — audits SLO docs for 7 common bugs:
                                 target ≥99.99, target ≤99, window <7d,
                                 window >90d, no SLI definition, no error
                                 budget policy, CPU-as-SLI.

4 reference docs:
- slo_principles.md   — SLI vs SLO vs SLA, Google SRE Workbook canon
- sli_design.md       — 5 SLI types with examples and anti-patterns
- error_budget.md     — error budget math, burn-rate alerts, budget policy
- composition.md      — how SLOs feed feature-flags, chaos, kubernetes-operator

Asset templates:
- slo_template.yaml          — fillable SLO YAML with all required fields
- error_budget_policy.md     — fillable 4-state policy (HEALTHY / CAUTION /
                                CRITICAL / VIOLATED)

Plus: SKILL.md, README.md, /slo-design slash command.

## Composition with prior phases

Explicit wire-up to the rest of the portfolio:
- feature-flags-architect.kill_switch_audit references SLO burn-rate
- chaos-engineering.blast_radius_calculator takes SLO error budget as input
- kubernetes-operator capability level L4 requires SLOs + Prometheus rules

The SLO is the unifying number: rollout abort, chaos blast radius, and
operator capability all reference it. references/composition.md walks
through end-to-end use.

## Audit verdict (evidence-based)

Closest existing skill: engineering/observability-designer covers SLI/SLO as
ONE topic among many (metrics, logs, traces, dashboards, alerting). It has
no dedicated tools and is breadth-not-depth. slo-architect is the focused
SLO discipline with deterministic Python tools — same gap pattern as
kubernetes-operator vs senior-devops.

## Marketplace / registry

- marketplace.json: slo-architect registered as standalone plugin
- engineering-advanced-skills bundle: 49 → 50 skills, version → 2.4.4
- engineering/.claude-plugin/plugin.json: version + skill list updated
- mkdocs.yml: nav entry under "Engineering - POWERFUL"
- docs/skills/engineering/slo-architect.md: docs page (manual)
- docs/commands/slo-design.md: auto-generated
- .codex/, .gemini/: synced

## Karpathy-coder gates

- complexity_checker (strict): 95/100 average — same top score as
  chaos-engineering. 1 WARN (depth 7 in slo_review.py from generator
  expressions). Verdict: WARN, not FAIL.
- All 1689 tests pass (was 1671; +18 for the new skill).
- mkdocs build --strict: succeeded in 12.47s.

## Verifiable success criteria (all green)

✓  scripts/*.py --help     → exit 0 for all 3 scripts
✓  SKILL.md frontmatter    → name + description + tags + compatible_tools
✓  plugin.json schema      → 8 fields exact (verified)
✓  sync_skill_bundles      → standalone ↔ bundled mirror in sync
✓  marketplace.json        → standalone entry + bundle counts updated
✓  generate-docs.py        → command page generated (skill page manual)
✓  mkdocs build --strict   → succeeded
✓  cross-tool sync         → codex + gemini synced
✓  pytest tests/           → 1689 passed, 0 failed
✓  CHANGELOG.md            → [Unreleased] entry expanded for Phase 4
✓  Self-test               → error_budget_calculator on 99.9% / 28d emits
                             correct burn-rate (14.4 fast, 6 slow, 1 ticket)
✓  Composition             → references named skills explicitly compose

## Phase 1+2+3+4 cumulative

- 4 new skills: feature-flags-architect, kubernetes-operator,
                chaos-engineering, slo-architect
- 12 new Python tools (all stdlib, all <250 LOC, average complexity 92/100)
- 16 new reference docs
- 4 new slash commands (/flag-cleanup, /operator-audit, /chaos-experiment,
                        /slo-design)

https://claude.ai/code/session_01Dq12xJakFRxwaoU8Pqejdm

Co-authored-by: Claude <noreply@anthropic.com>
 2026-05-10 07:39:05 +02:00
Claude
23eefc2e9a
feat(skills): ship chaos-engineering (Phase 3 — resilience testing discipline) 
Phase 3 of the multi-skill build effort. Same 14-step pipeline. Composes
explicitly with feature-flags-architect (kill switches as abort triggers)
and kubernetes-operator (operators are common chaos targets).

## What landed

### New skill: engineering/chaos-engineering

End-to-end chaos engineering discipline. Published as BOTH:
- Standalone plugin: engineering/chaos-engineering/
- Bundled mirror:    engineering/skills/chaos-engineering/

3 stdlib-only Python tools (Karpathy complexity 95/100 — best in portfolio):
- experiment_designer.py        — generates structured plans with hypothesis,
                                   steady-state, blast radius, abort criteria,
                                   rollback. Refuses to render plans without
                                   abort criteria (exit code 1).
- blast_radius_calculator.py    — computes affected users + error budget
                                   consumption + GREEN/YELLOW/RED risk score.
                                   Validates inputs (0 ≤ traffic-share ≤ 1).
- experiment_postmortem.py      — blameless postmortems from plan + result log;
                                   detects blame-laden language ("fault of",
                                   "should have known", "stupid", etc.) and
                                   warns at write time.

4 reference docs:
- chaos_principles.md      — 4 founding principles + 5th abort principle,
                              maturity model, history, when-to-start checklist
- experiment_design.md      — 7-section plan structure, pre-flight checklist,
                              time-boxing, escalation
- attack_taxonomy.md        — 7 attack types (latency / error / resource /
                              network-partition / dependency-failure / time-skew
                              / infrastructure) with magnitudes and tooling
- tooling_landscape.md      — Chaos Toolkit / Mesh / Litmus / Gremlin / AWS FIS
                              / DIY decision tree

Templates:
- experiment_template.md    — fill-in plan with all 7 sections
- postmortem_template.md    — blameless postmortem structure

Plus: SKILL.md (213 lines), README.md, /chaos-experiment slash command.

### Audit verdict (evidence-based)

Closest existing skills:
- engineering-team/incident-response — for actual incidents, not prevention
- engineering-team/red-team — adversarial; different goal (find attack paths)
- engineering-team/threat-detection — hunting; different goal
- engineering/observability-designer — measurement, not fault injection
None cover the chaos-engineering discipline (hypothesis-driven fault injection
with bounded blast radius). Verdict: BUILD. Gap is real and tooling-shaped.

### Composition story (Phase 1+2+3 form a stack)

```
feature-flags-architect.kill_switch_audit.py
  ↓ defines kill switches that ↓
chaos-engineering.experiment_designer.py
  ↓ designs experiments against ↓
kubernetes-operator (and other targets)
```

Together: a complete progressive-delivery + resilience-testing stack.

### Marketplace / registry

- marketplace.json: chaos-engineering registered as standalone plugin
- engineering-advanced-skills bundle: 47 → 48 skills, version → 2.4.2
- engineering/.claude-plugin/plugin.json: version + skill list updated
- mkdocs.yml: nav entry under "Engineering - POWERFUL"
- docs/skills/engineering/chaos-engineering.md: docs page (manual,
  pending generate-docs.py classification fix)
- docs/commands/chaos-experiment.md: auto-generated
- .codex/, .gemini/: synced

### Karpathy-coder gates

- complexity_checker (strict): 95/100 average — BEST score in the new
  portfolio. Only 1 WARN (depth 5 in blast_radius_calculator.py validation
  branches; the other 2 scripts hit no findings whatsoever).
- All 1666 tests pass (was 1648; added 18 for the new skill).
- mkdocs build --strict: succeeded in 13.33s.

### Verifiable success criteria (all green)

✓  scripts/*.py --help     → exit 0 for all 3 scripts
✓  SKILL.md frontmatter    → name + description + tags + compatible_tools
✓  plugin.json schema      → 8 fields exact (verified by check_plugin_json.py)
✓  sync_skill_bundles      → standalone ↔ bundled mirror in sync
✓  marketplace.json        → standalone entry + bundle counts updated
✓  generate-docs.py        → command page generated (skill page manual)
✓  mkdocs build --strict   → succeeded
✓  cross-tool sync         → codex + gemini synced
✓  pytest tests/           → 1666 passed, 0 failed
✓  CHANGELOG.md            → [Unreleased] entry expanded for Phase 3
✓  Self-test (RED case)    → 50% blast radius on 99.9% baseline correctly
                             classifies as RED (17.33% of monthly budget) and
                             returns ABORT recommendation
✓  Composition test        → references named skills explicitly compose

## Phase 1+2+3 cumulative

- 3 new skills: feature-flags-architect, kubernetes-operator, chaos-engineering
- 9 new Python tools (all stdlib, all <200 LOC, average complexity 90/100)
- 12 new reference docs (~250-500 lines each)
- 3 new slash commands (/flag-cleanup, /operator-audit, /chaos-experiment)
- 2 repo-infrastructure scripts (sync_skill_bundles, check_plugin_json)
- 1 pre-existing test fix (full-page-screenshot CI red)

## Files

- engineering/chaos-engineering/                                (new standalone plugin)
- engineering/skills/chaos-engineering/                         (new bundled mirror)
- commands/chaos-experiment.md                                  (new slash command)
- docs/skills/engineering/chaos-engineering.md                  (new docs page)
- docs/commands/chaos-experiment.md                             (auto-generated)
- mkdocs.yml                                                    (nav entries)
- .claude-plugin/marketplace.json                               (registered)
- engineering/.claude-plugin/plugin.json                        (bundle bumped)
- CHANGELOG.md                                                  ([Unreleased] expanded)
- .codex/, .gemini/                                             (cross-tool sync)

https://claude.ai/code/session_01Dq12xJakFRxwaoU8Pqejdm
 2026-05-09 21:24:16 +00:00
Claude
6c16309801
feat(skills): ship kubernetes-operator (Phase 2 — operator pattern discipline) 
Phase 2 of the multi-skill build effort. Same 14-step pipeline as Phase 1.

## What landed

### New skill: engineering/kubernetes-operator

End-to-end Kubernetes Operator discipline. Published as BOTH:
- Standalone plugin: engineering/kubernetes-operator/
- Bundled mirror:    engineering/skills/kubernetes-operator/

3 stdlib-only Python tools:
- crd_validator.py            — checks CRD YAMLs for status subresource,
                                 structural schema, conditions array, printer
                                 columns, version policy, scope
- reconcile_lint.py            — finds reconcile-loop bugs in Go: time.Sleep,
                                 spec mutation via r.Update, missing requeue,
                                 oversized reconcile bodies, panic/os.Exit,
                                 unbalanced finalizer add/remove
- operator_capability_audit.py — scores against OperatorHub Capability
                                 Levels 1-5 with concrete next-level steps

4 reference docs:
- operator_pattern.md   — what an operator IS, when to use vs Helm/Deployment
- crd_design.md         — anatomy of a production CRD, versioning, conversion
- reconcile_loop.md     — idempotence patterns, error/requeue, status subresource
- tooling_landscape.md  — controller-runtime / kubebuilder / operator-sdk /
                          metacontroller / KOPF / java-operator-sdk decision tree

Asset templates:
- crd_template.yaml       — passes crd_validator.py PASS-clean
- reconcile_skeleton.go   — passes reconcile_lint.py PASS-clean

Plus: SKILL.md (213 lines), README.md, /operator-audit slash command.

### Audit verdict (evidence-based)

Closest existing coverage:
- engineering-team/senior-devops — kubectl / blue-green deploys, no operators
- engineering/helm-chart-builder — Helm charts (different abstraction)
- engineering-team/cloud-security — k8s RBAC at high level
None cover the Operator pattern (CRD + controller + reconcile loop).
Verdict: BUILD. Gap is real and tooling-shaped.

### Self-test (meta-validation)

During build, the new linters caught 4 real bugs in their own asset templates:
- crd_validator.py wrongly anchored regexes to start-of-line, misclassifying
  indented YAML keys (scope, singular, listKind) as missing
- reconcile_lint.py checked finalizer add/remove balance per-function,
  missing the cross-function pattern in the asset (Add in main reconcile,
  Remove in reconcileDelete)
Both linters fixed; assets re-tested; both PASS clean.

This is Karpathy principle 4 in action: verifiable goals catch real bugs.

### Marketplace / registry

- marketplace.json: kubernetes-operator registered as standalone plugin
- engineering-advanced-skills bundle: 45 → 46 → 47 skills, version → 2.4.1
- engineering/.claude-plugin/plugin.json: version + skill list updated
- mkdocs.yml: nav entry under "Engineering - POWERFUL"
- docs/skills/engineering/kubernetes-operator.md: docs page (manual,
  pending generate-docs.py classification fix)
- docs/commands/operator-audit.md: auto-generated
- .codex/, .gemini/: synced

### Karpathy-coder gates

- complexity_checker (strict): 85/100 average, depth-4-to-6 WARNs (lambdas
  in capability audit). Same range as karpathy-coder's own scripts (70/100
  baseline). Verdict: WARN, not FAIL.
- All 1648 tests pass (was 1630; added 18 for the new skill).
- mkdocs build --strict: succeeded in 14.44s.

### Verifiable success criteria (all green)

✓  scripts/*.py --help     → exit 0 for all 3 scripts
✓  SKILL.md frontmatter    → name + description + tags + compatible_tools
✓  plugin.json schema      → 8 fields exact (verified by check_plugin_json.py)
✓  sync_skill_bundles      → standalone ↔ bundled mirror in sync
✓  marketplace.json        → standalone entry + bundle counts updated
✓  generate-docs.py        → command page generated (skill page manual)
✓  mkdocs build --strict   → succeeded
✓  cross-tool sync         → codex + gemini synced
✓  pytest tests/           → 1648 passed, 0 failed
✓  CHANGELOG.md            → [Unreleased] entry expanded
✓  Self-test               → linters caught + fixed 4 real bugs in own assets

## Files

- engineering/kubernetes-operator/                              (new standalone plugin)
- engineering/skills/kubernetes-operator/                       (new bundled mirror)
- commands/operator-audit.md                                    (new slash command)
- docs/skills/engineering/kubernetes-operator.md                (new docs page)
- docs/commands/operator-audit.md                               (auto-generated)
- mkdocs.yml                                                    (nav entries)
- .claude-plugin/marketplace.json                               (registered)
- engineering/.claude-plugin/plugin.json                        (bundle bumped)
- CHANGELOG.md                                                  ([Unreleased] expanded)
- .codex/, .gemini/                                             (cross-tool sync)

https://claude.ai/code/session_01Dq12xJakFRxwaoU8Pqejdm
 2026-05-09 09:01:45 +00:00
Claude
0c7d19d297
feat(skills): ship feature-flags-architect (Phase 1 pilot — dual-publish) 
Phase 1 of the multi-skill build effort. Ships the first new skill end-to-end
through the 14-step pipeline: scoped, audited, built, gated, mirrored, doc'd,
and registered.

## What landed

### New skill: engineering/feature-flags-architect

End-to-end feature-flag discipline. Published as BOTH:
- Standalone plugin: engineering/feature-flags-architect/
- Bundled mirror:    engineering/skills/feature-flags-architect/

3 stdlib-only Python tools:
- flag_debt_scanner.py — finds stale flags via git log -S + age heuristic
- rollout_planner.py   — generates ring/linear/log/cohort phased schedule
- kill_switch_audit.py — verifies every flag has documented kill switch

4 reference docs:
- flag_taxonomy.md       — 4 types decision tree (Release/Experiment/Operational/Permission)
- provider_comparison.md — LaunchDarkly/GrowthBook/Statsig/Unleash/Flipt/DIY trade-offs
- rollout_strategies.md  — strategies, abort criteria, hold-time rules
- flag_lifecycle.md      — 6-phase lifecycle (request → archive) with SLAs + worked example

Plus: SKILL.md (213 lines), README.md, asset template, /flag-cleanup slash command.

### Audit verdict (evidence-based)

Closest existing skill: engineering/skills/release-manager (~30 lines on flags;
documents 4 types + Python integration example). marketing-skill/ab-test-setup
references flags only in tooling list. Neither provides debt scanner, rollout
planner, or kill-switch audit. Verdict: BUILD. Gap is real and tooling-shaped.

### Marketplace / registry

- marketplace.json: feature-flags-architect registered as standalone plugin
- engineering-advanced-skills bundle: 44 → 45 skills, version 2.3.3 → 2.4.0
- engineering/.claude-plugin/plugin.json: version bumped + skill listed
- mkdocs.yml: nav entry under "Engineering - POWERFUL"
- docs/skills/engineering/feature-flags-architect.md: docs page (manual,
  generate-docs.py has a pre-existing classification bug fixing top-level
  vs sub-skill detection — out of scope this turn)
- docs/commands/flag-cleanup.md: auto-generated by generate-docs.py
- .codex/skills/feature-flags-architect: symlink created
- .gemini/skills/feature-flags-architect: synced

### Karpathy-coder gates (per user directive: block on FAIL)

- complexity_checker (strict): 90/100 average (1 WARN per script on nesting
  depth — same intrinsic pattern as canonical karpathy-coder tools, which
  themselves score 70/100 strict). Verdict: WARN, not FAIL.
- diff_surgeon: NOISY (whitespace + docstrings flagged on new files —
  intrinsic false-positive for greenfield code; karpathy-coder's own scripts
  hit the same noise pattern).
- goal_verifier: same MISSING verdict as the flagship llm-wiki SKILL.md;
  literal `→ verify:` syntax not used (would harm readability).
- All 1630 tests pass (was 1629; added 12 smoke + 6 integrity for the new skill).

### Verifiable success criteria (all green)

✓  scripts/*.py --help     → exit 0 for all 3 scripts
✓  SKILL.md frontmatter    → name + description + tags + compatible_tools
✓  plugin.json schema      → 8 fields exact (verified by check_plugin_json.py)
✓  sync_skill_bundles --check engineering/feature-flags-architect → exit 0
✓  marketplace.json        → standalone entry + bundle version bumped
✓  generate-docs.py        → command page generated (skill page manual)
✓  mkdocs build --strict   → succeeded in 14.81s
✓  cross-tool sync         → codex + gemini synced
✓  pytest tests/           → 1630 passed, 0 failed
✓  CHANGELOG.md            → [Unreleased] entry added
✓  False-positive purge    → removed FLAG_X regex pattern from scanner after
                             it matched my own FLAG_PATTERNS constant

## Files

- engineering/feature-flags-architect/                          (new standalone plugin)
- engineering/skills/feature-flags-architect/                   (new bundled mirror)
- commands/flag-cleanup.md                                      (new slash command)
- docs/skills/engineering/feature-flags-architect.md            (new docs page)
- docs/commands/flag-cleanup.md                                 (auto-generated)
- mkdocs.yml                                                    (nav entries)
- .claude-plugin/marketplace.json                               (registered)
- engineering/.claude-plugin/plugin.json                        (bundle bumped)
- CHANGELOG.md                                                  ([Unreleased] entry)
- .codex/, .gemini/                                             (cross-tool sync)

https://claude.ai/code/session_01Dq12xJakFRxwaoU8Pqejdm
 2026-05-09 06:10:43 +00:00
Reza Rezvani
dbd652ca72 docs: regenerate index pages for karpathy-coder + Hermes sync 
Auto-generated index pages updated by generate-docs.py:
- docs/agents/index.md — added cs-karpathy-reviewer
- docs/commands/index.md — added /karpathy-check
- docs/skills/engineering/index.md — added karpathy-coder

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-04-13 09:19:31 +02:00
Reza Rezvani
64aa1fd8f9 docs: promote Hermes Agent as 12th supported tool across all docs 
Hermes Agent (github.com/NousResearch/hermes-agent) uses the same
agentskills.io SKILL.md standard — no format conversion needed. This commit
updates every documentation surface to reflect Hermes as the 12th officially
supported tool (up from 11).

Files updated (10):

README.md:
- Title: "11 AI coding tools" → "12 AI coding tools"
- Works-with line: added "Hermes Agent" after OpenClaw
- Multi-Tool Support table: added Hermes row with sync-hermes-skills.py
- FAQ: updated tool count and mentioned Hermes sync script

CLAUDE.md:
- v2.0.0 history: "Multi-platform support" line expanded to list Hermes

docs/index.md:
- Meta description: added Hermes
- Hero subtitle: 12 AI coding tools
- Grid cards: "12 Tool Support" + updated multi-tool description
- Quick Install: added "Hermes Agent" tab with sync command

docs/getting-started.md:
- Meta description: 12 AI coding tools
- Installation tabs: added full "Hermes Agent" tab with sync options
- FAQ: 12 tools

docs/integrations.md:
- Title: added "Hermes"
- Description: 12 AI coding agents
- Intro paragraph: updated tool count, noted Hermes needs no conversion
- Grid cards: added Hermes Agent card
- NEW SECTION: "## Hermes Agent" — full install guide with sync script
  (recommended), single-domain, copy mode, and manual options. Includes
  compatibility table, usage instructions, verify steps, and update guide.
- Install locations table: added Hermes (~/.hermes/skills/claude-skills/)
- FAQ: added "Does Hermes Agent need format conversion?" entry
- Troubleshooting: updated bundle-capable tools list to include Hermes

.claude-plugin/marketplace.json:
- Metadata description: added "Hermes Agent" to compatible-tools list

mkdocs.yml:
- site_description: 12 AI coding tools, updated skill/agent counts

docs pages regenerated: 296 pages (238 skills + 29 agents + 29 commands)
MkDocs build: clean, 0 errors

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-04-13 08:19:46 +02:00
Reza Rezvani
7fb04a4d6b docs: sync counts + regenerate pages for llm-wiki, apple-hig, tc-tracker 
Run the full /update-docs pipeline after merging dev (apple-hig-expert,
tc-tracker) into the llm-wiki feature branch.

Count alignment (235 skills, 314 Python tools, 435 refs, 28 agents, 27 commands):
- Root CLAUDE.md: scope line, v2.3.0 highlights (added tc-tracker + apple-hig
  bullets), footer
- README.md: badges (Skills 235, Agents 28, Commands 27), tagline, skill
  overview table (engineering 45, product 16)
- docs/index.md: title, hero subtitle, grid cards (235 skills, 28 agents,
  314 tools, 30 plugins, 27 commands), domain cards (engineering 45, product 16)
- docs/getting-started.md: description, tool count, FAQ skill count
- product-team/CLAUDE.md: 15 → 16 skills, added spec-to-repo to list

Plugin manifests:
- product-team/apple-hig-expert/.claude-plugin/plugin.json — NEW. The skill
  was in marketplace.json but lacked its own standalone plugin.json, so it
  couldn't be installed as an individual plugin. Created with v2.3.0.
- engineering/.claude-plugin/plugin.json: 44 → 45 skills, added tc-tracker
- product-team/.claude-plugin/plugin.json: 14 → 16 skills, version 2.1.2 →
  2.3.0, added apple-hig-expert and spec-to-repo
- .claude-plugin/marketplace.json: apple-hig-expert entry 2.2.0 → 2.3.0

Generated pages (mkdocs):
- scripts/generate-docs.py: 293 pages (237 skills + 28 agents + 28 commands)
- New skill pages: docs/skills/engineering/llm-wiki.md, tc-tracker.md,
  docs/skills/product-team/apple-hig-expert.md
- New agent pages: cs-wiki-{ingestor,librarian,linter}.md
- New command pages: wiki-{init,ingest,query,lint,log}.md, tc.md
- mkdocs.yml nav: added the 3 new skills (engineering + product sections)
  and /tc command

Ecosystem sync:
- .codex: 197 symlinks across 9 categories (engineering 45, engineering-team
  36, product 16, marketing 44, c-level 28, ra-qm 13, pm 8, business 4,
  finance 3)
- .gemini: 294 items (2 updated, tc/ symlink added)

Build verified: mkdocs build clean (0 errors, 8s), consistency check pass.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-04-11 02:03:00 +02:00
Reza Rezvani
7533d34978 chore: post-merge sync — statistical-analyst plugin, spec-to-repo skill, docs update 
New:
- feat(product-team): add spec-to-repo skill — natural-language spec to runnable repo
  1 Python tool (validate_project.py), 2 references, 3 concrete examples
- feat(engineering): add statistical-analyst plugin.json + marketplace entry (32 total)

Sync:
- Update all counts to 233 skills, 305 tools, 424 refs, 25 agents, 22 commands
- Fix engineering-advanced plugin description: 42 → 43 skills
- Sync Codex (194 skills), Gemini (282 items), MkDocs (281 pages → 313 HTML)
- Update CLAUDE.md, README.md, docs/index.md, docs/getting-started.md, mkdocs.yml
- Expand product-analytics SKILL.md + add JSON output to metrics_calculator.py

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-04-07 12:09:55 +02:00
Reza Rezvani
5710a7b763 chore: post-merge sync — plugins, audits, docs, cross-platform indexes 
New skills integrated:
- engineering/behuman, code-tour, demo-video, data-quality-auditor

Plugins & marketplace:
- Add plugin.json for code-tour, demo-video, data-quality-auditor
- Add all 3 to marketplace.json (31 total plugins)
- Update marketplace counts to 248 skills, 332 tools, 460 refs

Skill fixes:
- Move data-quality-auditor from data-analysis/ to engineering/
- Fix cross-refs: code-tour, demo-video, data-quality-auditor
- Add evals.json for code-tour (5 scenarios) and demo-video (4 scenarios)
- demo-video: add output artifacts, prereqs check, references extraction
- code-tour: add default persona, parallel discovery, trivial repo guidance
- Fix Python 3.9 compat (from __future__ import annotations)

product-analytics audit fixes:
- Expand SKILL.md from 82 to 147 lines (anti-patterns, cross-refs, examples)
- Add --format json to all metrics_calculator.py subcommands
- Add error handling (FileNotFoundError, KeyError)

Docs & indexes:
- Update CLAUDE.md, README.md, docs/index.md, docs/getting-started.md counts
- Sync Codex (192 skills) and Gemini (280 items) indexes
- Regenerate MkDocs pages (279 pages, 311 HTML)
- Add 3 new nav entries to mkdocs.yml
- Update mkdocs.yml site_description

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-04-04 02:05:19 +02:00
Reza Rezvani
baca2e61ac feat(engineering): add behuman skill — Self-Mirror consciousness loop 
Based on issue #464 submission by voidborne-d. Enhanced with English-only
content (removed all Chinese), anti-patterns section, cross-references,
plugin.json, convention-compliant frontmatter, and English eval scenarios.

behuman (193 lines + reference + 8 eval scenarios):
- Self-Mirror loop: instinctive response → reflection → conscious revision
- Show mode (2.5-3x tokens) and quiet mode (1.5-2x tokens)
- 3 English examples: emotional support, life advice, personal writing
- Based on Lacan's Mirror Stage + Kahneman's Dual Process Theory
- Zero dependencies — pure prompt technique

Co-Authored-By: voidborne-d <voidborne-d@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-04-03 01:54:01 +02:00
Reza Rezvani
1f374e7492 feat: add 4 community skills — llm-cost-optimizer, prompt-governance, business-investment-advisor, video-content-strategist 
Based on PR #448 by chad848. Enhanced with frontmatter normalization,
anti-patterns sections, ghost script reference removal, and broken
cross-reference fixes. Automotive-electrical-engineer excluded (out of
scope for software/AI skills library).

llm-cost-optimizer (engineering/, 192 lines):
- Reduce LLM API spend 40-80% via model routing, caching, compression
- 3 modes: Cost Audit, Optimize, Design Cost-Efficient Architecture

prompt-governance (engineering/, 224 lines):
- Production prompt lifecycle: versioning, eval pipelines, A/B testing
- Distinct from senior-prompt-engineer (writing) — this is ops/governance

business-investment-advisor (finance/, 220 lines):
- Capital allocation: ROI, NPV, IRR, payback, build-vs-buy, lease-vs-buy
- NOT securities advice — business capex decisions only

video-content-strategist (marketing-skill/, 218 lines):
- YouTube strategy, video scripting, short-form pipelines, content atomization
- Fills video gap in 44-skill marketing pod

Co-Authored-By: chad848 <chad848@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-31 11:43:03 +02:00
Claude
c8520885f9
feat: full ecosystem integration for PR #435 (5 security skills) and PR #436 (self-eval) 
- Updated domain plugin.json counts (engineering-team: 36, engineering: 36)
- Added 6 new skills to mkdocs.yml navigation
- Updated engineering-team/CLAUDE.md with security skills section
- Generated docs pages for all 6 new skills
- Synced Codex + Gemini indexes and symlinks
- Ran cross-platform conversion (Cursor, Aider, Windsurf, KiloCode, OpenCode, Augment, Antigravity)

https://claude.ai/code/session_01XY4i7SR4BHLWJpdjwGnNLG
 2026-03-30 19:11:46 +00:00
Reza Rezvani
86fc905e97 chore: sync cross-platform indexes, regenerate docs, fix plugin.json counts 
- Codex CLI: 174 skills synced, 11 new symlinks
- Gemini CLI: 262 items synced, 11 new
- engineering plugin.json: 33 → 35 skills
- engineering-team plugin.json: 28 → 29 skills
- Docs regenerated: 261 pages (214 skills + 25 agents + 22 commands)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-25 15:42:39 +01:00
Reza Rezvani
43bb5c4d59 Merge branch 'feature/sprint-phase-3-gaps' into dev 
# Conflicts:
#	docs/skills/engineering-team/index.md
#	docs/skills/engineering/index.md
#	mkdocs.yml
 2026-03-25 14:23:21 +01:00
Reza Rezvani
87f3a007c9 feat(engineering,ra-qm): add secrets-vault-manager, sql-database-assistant, gcp-cloud-architect, soc2-compliance 
secrets-vault-manager (403-line SKILL.md, 3 scripts, 3 references):
- HashiCorp Vault, AWS SM, Azure KV, GCP SM integration
- Secret rotation, dynamic secrets, audit logging, emergency procedures

sql-database-assistant (457-line SKILL.md, 3 scripts, 3 references):
- Query optimization, migration generation, schema exploration
- Multi-DB support (PostgreSQL, MySQL, SQLite, SQL Server)
- ORM patterns (Prisma, Drizzle, TypeORM, SQLAlchemy)

gcp-cloud-architect (418-line SKILL.md, 3 scripts, 3 references):
- 6-step workflow mirroring aws-solution-architect for GCP
- Cloud Run, GKE, BigQuery, Cloud Functions, cost optimization
- Completes cloud trifecta (AWS + Azure + GCP)

soc2-compliance (417-line SKILL.md, 3 scripts, 3 references):
- SOC 2 Type I & II preparation, Trust Service Criteria mapping
- Control matrix generation, evidence tracking, gap analysis
- First SOC 2 skill in ra-qm-team (joins GDPR, ISO 27001, ISO 13485)

All 12 scripts pass --help. Docs generated, mkdocs.yml nav updated.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-25 14:05:11 +01:00
Reza Rezvani
97952ccbee feat(engineering): add browser-automation and spec-driven-workflow skills 
browser-automation (564-line SKILL.md, 3 scripts, 3 references):
- Web scraping, form filling, screenshot capture, data extraction
- Anti-detection patterns, cookie/session management, dynamic content
- scraping_toolkit.py, form_automation_builder.py, anti_detection_checker.py
- NOT testing (that's playwright-pro) — this is automation & scraping

spec-driven-workflow (586-line SKILL.md, 3 scripts, 3 references):
- Spec-first development: write spec BEFORE code
- Bounded autonomy rules, 6-phase workflow, self-review checklist
- spec_generator.py, spec_validator.py, test_extractor.py
- Pairs with tdd-guide for red-green-refactor after spec

Updated engineering plugin.json (31 → 33 skills).
Added both to mkdocs.yml nav and generated docs pages.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-25 12:57:18 +01:00
Reza Rezvani
ce1d7925cc feat(engineering): integrate focused-fix skill — docs, command, agent, marketplace 
- Normalize SKILL.md frontmatter to repo standard (remove non-standard
  license, metadata.* fields; inline description)
- Generate docs page (docs/skills/engineering/focused-fix.md)
- Add to mkdocs.yml nav (skills + commands)
- Create /focused-fix slash command (commands/ + .claude/commands/)
- Add to cs-senior-engineer agent (skill integration + new workflow #4)
- Update marketplace.json and plugin.json descriptions (30 → 31 skills)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-23 13:59:30 +01:00
Reza Rezvani
219c1c3dfd fix(seo): fix multi-line YAML description parser, add 2 orphan pages to nav 
- generate-docs.py: extract_description_from_frontmatter() now handles
  multi-line YAML block scalars (|, >, indented continuation) — fixes
  14 pages that had 56-65 char truncated descriptions
- mkdocs.yml: add epic-design and research-summarizer to nav (orphan pages)
- Regenerated 251 pages, rebuilt sitemap (278 URLs)
- SEO audit: 0 broken links, 17→3 short descriptions, 278/278 pages
  have "Claude Code Skills" in <title>

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-18 10:57:08 +01:00
Reza Rezvani
2f57ef8948 feat(agenthub): add AgentHub plugin with cross-domain examples, SEO optimization, and docs site fixes 
- AgentHub: 13 files updated with non-engineering examples (content drafts,
  research, strategy) — engineering stays primary, cross-domain secondary
- AgentHub: 7 slash commands, 5 Python scripts, 3 references, 1 agent,
  dry_run.py validation (57 checks)
- Marketplace: agenthub entry added with cross-domain keywords, engineering
  POWERFUL updated (25→30), product (12→13), counts synced across all configs
- SEO: generate-docs.py now produces keyword-rich <title> tags and meta
  descriptions using SKILL.md frontmatter — "Claude Code Skills" in site_name
  propagates to all 276 HTML pages
- SEO: per-domain title suffixes (Agent Skill for Codex & OpenClaw, etc.),
  slug-as-title cleanup, domain label stripping from titles
- Broken links: 141→0 warnings — new rewrite_skill_internal_links() converts
  references/, scripts/, assets/ links to GitHub source URLs; skills/index.md
  phantom slugs fixed (6 marketing, 7 RA/QM)
- Counts synced: 204 skills, 266 tools, 382 refs, 16 agents, 17 commands,
  21 plugins — consistent across CLAUDE.md, README.md, docs/index.md,
  marketplace.json, getting-started.md, mkdocs.yml
- Platform sync: Codex 163 skills, Gemini 246 items, OpenClaw compatible

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-17 12:10:46 +01:00
Reza Rezvani
7911cf957a feat(autoresearch-agent): fix critical bugs, package as plugin with 5 slash commands 
**Bug fixes (run_experiment.py):**
- Fix broken revert logic: was saving HEAD as pre_commit (no-op revert),
  now uses git reset --hard HEAD~1 for correct rollback
- Remove broken --loop mode (agent IS the loop, script handles one iteration)
- Fix shell injection: all git commands use subprocess list form
- Replace shell tail with Python file read

**Bug fixes (other scripts):**
- setup_experiment.py: fix shell injection in git branch creation,
  remove dead --skip-baseline flag, fix evaluator docstring parsing
- log_results.py: fix 6 falsy-zero bugs (baseline=0 treated as None),
  add domain_filter to CSV/markdown export, move import time to top
- evaluators: add FileNotFoundError handling, fix output format mismatch
  in llm_judge_copy, add peak_kb on macOS, add ValueError handling

**Plugin packaging (NEW):**
- plugin.json, settings.json, CLAUDE.md for plugin registry
- 5 slash commands: /ar:setup, /ar:run, /ar:loop, /ar:status, /ar:resume
- /ar:loop supports user-selected intervals (10m, 1h, daily, weekly, monthly)
- experiment-runner agent for autonomous loop iterations
- Registered in marketplace.json as plugin #20

**SKILL.md rewrite:**
- Replace ambiguous "Loop Protocol" with clear "Agent Protocol"
- Add results.tsv format spec, strategy escalation, self-improvement
- Replace "NEVER STOP" with resumable stopping logic

**Docs & sync:**
- Codex (157 skills), Gemini (229 items), convert.sh all pick up the skill
- 6 new MkDocs pages, mkdocs.yml nav updated
- Counts updated: 17 agents, 22 slash commands

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-13 14:38:59 +01:00
Reza Rezvani
670930c69d feat(docs): implement unified design system across all generated pages 
- Add CSS components: .page-meta badges, .domain-header, .install-banner
- Fix invisible tab navigation (explicit color for light/dark modes)
- Rewrite generate-docs.py with design system templates
- Domain indexes: centered headers with icons, install banners, grid cards
- Skill pages: pill badges (domain, skill ID, source), install commands
- Agent/command pages: type badges with domain icons
- Regenerate all 210 pages (180 skills + 15 agents + 15 commands)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-11 12:32:49 +01:00
Reza Rezvani
67f3922e4f feat(product,pm): world-class product & PM skills audit — 6 scripts, 5 agents, 7 commands, 23 references/assets 
Phase 1 — Agent & Command Foundation:
- Rewrite cs-project-manager agent (55→515 lines, 4 workflows, 6 skill integrations)
- Expand cs-product-manager agent (408→684 lines, orchestrates all 8 product skills)
- Add 7 slash commands: /rice, /okr, /persona, /user-story, /sprint-health, /project-health, /retro

Phase 2 — Script Gap Closure (2,779 lines):
- jira-expert: jql_query_builder.py (22 patterns), workflow_validator.py
- confluence-expert: space_structure_generator.py, content_audit_analyzer.py
- atlassian-admin: permission_audit_tool.py
- atlassian-templates: template_scaffolder.py (Confluence XHTML generation)

Phase 3 — Reference & Asset Enrichment:
- 9 product references (competitive-teardown, landing-page-generator, saas-scaffolder)
- 6 PM references (confluence-expert, atlassian-admin, atlassian-templates)
- 7 product assets (templates for PRD, RICE, sprint, stories, OKR, research, design system)
- 1 PM asset (permission_scheme_template.json)

Phase 4 — New Agents:
- cs-agile-product-owner, cs-product-strategist, cs-ux-researcher

Phase 5 — Integration & Polish:
- Related Skills cross-references in 8 SKILL.md files
- Updated product-team/CLAUDE.md (5→8 skills, 6→9 tools, 4 agents, 5 commands)
- Updated project-management/CLAUDE.md (0→12 scripts, 3 commands)
- Regenerated docs site (177 pages), updated homepage and getting-started

Quality audit: 31 files reviewed, 29 PASS, 2 fixed (copy-frameworks.md, governance-framework.md)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-10 01:08:45 +01:00
Reza Rezvani
885fe8b023 docs: update all documentation with accurate counts and regenerated skill pages 
- Update skill count to 170, Python tools to 213, references to 314 across all docs
- Regenerate all 170 skill doc pages from latest SKILL.md sources
- Update CLAUDE.md with v2.1.1 highlights, accurate architecture tree, and roadmap
- Update README.md badges and overview table
- Update marketplace.json metadata description and version
- Update mkdocs.yml, index.md, getting-started.md with correct numbers
 2026-03-09 08:14:11 +01:00
Reza Rezvani
2c72babd52 feat: add MkDocs Material docs site with 170 auto-generated skill pages 
- mkdocs.yml: Material theme with dark/light mode, search, tabs, sitemap
- scripts/generate-docs.py: auto-generates docs from all SKILL.md files
- docs/index.md: landing page with domain overview and quick install
- docs/getting-started.md: installation guide for Claude Code, Codex, OpenClaw
- docs/skills/: 170 skill pages + 9 domain index pages
- .github/workflows/static.yml: MkDocs build + GitHub Pages deploy
- .gitignore: exclude site/ build output

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-06 12:16:26 +01:00