scriptoriumadmin/claude-skills
1
0
Fork 0
mirror of https://github.com/alirezarezvani/claude-skills.git synced 2026-10-04 02:31:53 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
955 commits 6 branches 7 tags 43 MiB
Commit graph

85 commits

Author SHA1 Message Date
Alireza Rezvani
7562c964ab
Fix link formatting in getting-started.md 2026-05-19 12:04:43 +02:00
Alireza Rezvani
d25a2b1b9e
Merge pull request #697 from alirezarezvani/alirezarezvani-patch-1 
Alirezarezvani patch 1
 2026-05-19 12:01:11 +02:00
Alireza Rezvani
710cde3874
Update getting-started.md 2026-05-19 12:00:28 +02:00
Claude
32a0da53a4
chore(v2.8.0-sprint3): cross-platform sync + docs generation + MkDocs nav + CHANGELOG 
Sprint 3 closure for v2.8.0. Brings the 2 new top-level domains
(business-operations + commercial) to release-ready by extending the
cross-platform sync infrastructure, the docs generator, and the MkDocs
nav to recognize them.

## Cross-platform sync (codex / gemini / hermes)

- scripts/sync-codex-skills.py — SKILL_DOMAINS extended with
  business-operations + commercial. Regenerated .codex/skills/ symlinks
  for 15 new skills + .codex/skills-index.json with full descriptions.
- scripts/sync-gemini-skills.py — DOMAIN_MAP extended with all 5 v2.7.0+
  v2.8.0 top-level domains (productivity, marketing-top-level, research,
  business-operations, commercial). +30 items synced.
- scripts/sync-hermes-skills.py — DOMAIN_DIRS extended with
  business-operations + commercial.

## Docs generation (Pass 2 command/agent discovery)

scripts/generate-docs.py extended with:

- DOMAINS dict extended with business-operations (sort=13) and commercial
  (sort=14) entries.
- Pass 2 for agent discovery — walks <domain>/agents/<agent>.md
  (v2.8.0 pattern), in addition to <domain>/<plugin>/agents/<agent>.md
  (legacy pattern).
- Pass 2 for command discovery — walks <domain>/commands/<cmd>.md
  (v2.8.0 pattern) AND <domain>/<skill>/commands/<cmd>.md (v2.7.0
  pattern). Previously, only root-level commands/*.md were discovered;
  35 commands were orphaned (v2.7.0 capture/pulse/landing/etc. +
  all v2.8.0 commands).

Result: 311 skill pages + 75 agent pages + 69 command pages = 455
total. Up from 311 + 73 + 34 = 418.

## MkDocs nav

mkdocs.yml updated with:

- Business Operations section (7 sub-skill nav entries)
- Commercial section (8 sub-skill nav entries)
- 2 new orchestrator agents added to Agents nav
- 17 new v2.8.0 slash commands added to Commands nav

MkDocs build succeeds (non-strict) in ~17s. Strict mode flags 3 pre-
existing broken links in older content (cs-aeo, grill-with-docs) —
out of scope for v2.8.0.

## CHANGELOG.md

v2.8.0 entry rewritten from "Sprint 1 only" to the full Sprint 1 + 2 + 3
view. All 13 sub-skills documented with canon attribution. Stats updated:

- 313 -> 328 skills (+15)
- 12 -> 14 top-level domains
- 60 -> 77 slash commands (+17)
- 402 -> 441 Python tools (+39)
- 542 -> 581 reference docs (+39)
- 46 -> 48 cs-* agents (+2)
- 57 -> 59 marketplace plugins (+2)
- 34 -> 69 documented commands in MkDocs (+35)

## Root CLAUDE.md

Updated Current Scope + Current Version to reflect v2.8.0 (released)
status. Sprint 1 "in-flight" -> "complete". Counts updated to
328 skills / 441 tools / 77 commands.

## Per-skill audit (scripts/audit_skills.py)

Ran across 329 total skills. All 13 v2.8.0 sub-skills audited with
skill_review_checklist_runner.py: 1 score 5/6, 7 score 4/6, 4 score
3/6, 1 score 2/6 (knowledge-ops). Dominant failure mode: rule #2
"SKILL.md under 100 lines" — known tension with our deliberate
Forcing-question library depth (mandatory per user direction). Tracked
as ADVISORY for skills that deliberately expose extended grill
discipline.

## Plugin manifest validation

scripts/check_plugin_json.py --all passes (exit 0) for all 47 plugin
manifests including the 2 new ones. The PR #690 validator recognizes
the source extension field per CLAUDE.md.

https://claude.ai/code/session_015bBb4HzWCf5HH5QK2TGtnW
 2026-05-19 06:02:00 +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
c111c01477
docs(hermes): add install + configure walkthrough — fixes user-flagged gap 
The user flagged that nowhere in the documentation do we guide users
through installing and configuring Hermes Agent itself with our skills.
PR #678 covered the technical integration but missed this user-facing
step.

Additions to docs/integrations.md Hermes Agent section:

**Step 1 — Install Hermes Agent itself (NEW)**
- macOS/Linux: 5-step setup (clone → venv → deps → .env → first run)
- Windows: WSL2 guidance
- Docker: one-liner with $HOME/.hermes volume mount
- Provider note: works with Nous, OpenAI, Anthropic, or any
  OpenAI-compatible endpoint (no Nous account required)

**Step 3 — First-run walkthrough (NEW)**
- Complete dry-run from cold install to first skill invocation
- Examples: /skills, /research <query>, /skill_view, /skills search
- Shows how our orchestrator routing surfaces in Hermes UX

**Configuration tips (NEW)**
- Sample ~/.hermes/config.yaml block with our skill paths
- auto_load recommendations (karpathy-coder always-on, grill-me sparingly)
- display: show_category for grouping by claude-skills/<domain>/

**Troubleshooting (NEW — 6 Q&A entries)**
1. /skills shows 0 results after sync (target path + permissions)
2. Symlinks point to wrong path (cross-machine portability — relative
   symlinks per v2.7.2+)
3. Slash command collisions (Hermes built-ins vs claude-skills)
4. ModuleNotFoundError on Python tools (3.10+ requirement)
5. SKILL.md not found despite file existing (nested-plugin flatten via
   sync script)
6. How to unsync (rm -rf ~/.hermes/skills/claude-skills/)

Also bumped verify count: 198+ → 303 (v2.7.2+) so the post-sync
sanity check now expects accurate numbers.

https://claude.ai/code/session_01FEUmeuYhmnxVFq7EZM8ZSw
 2026-05-17 05:54:29 +00:00
Claude
e8a718ce30
feat(hermes): upgrade Hermes Agent integration to first-class 
The user flagged that we advertise Hermes Agent as a tier-1 supported
platform in the "Works with:" list, but the actual integration was
significantly thinner than Codex/Gemini/OpenClaw:

- No committed .hermes/ tree (other platforms ship pre-generated trees)
- sync-hermes-skills.py DOMAIN_DIRS missing the 3 v2.7.0 top-level
  domains (productivity, marketing, research) — running it today would
  silently skip all 13 v2.7.0 skills
- Discover function only handled the flat `<domain>/<skill>/` pattern,
  missing the nested-plugin pattern `<domain>/<plugin>/skills/<skill>/`
  used by all v2.7.0 skills + many older plugins
- Doc count stale at "198+ skills" / "246 skills"
- 35 Hermes mentions vs Codex 1010 / Gemini 622 / OpenClaw 572 —
  under-documented relative to the marketing claim

This commit upgrades Hermes to first-class technical support while
labeling it BYO-sync in marketing (honest about the workflow:
pre-generated tree shipped, but user runs sync into ~/.hermes/ once).

**scripts/sync-hermes-skills.py changes:**

1. DOMAIN_DIRS extended with `productivity`, `marketing`, `research`
   (the 3 v2.7.0 top-level domains)
2. `discover_skills()` rewritten to handle all 3 SKILL.md location
   patterns (same logic as sync-codex-skills.py):
   - Pattern 1: `<domain>/<skill>/SKILL.md` (flat legacy)
   - Pattern 2: `<domain>/skills/<skill>/SKILL.md` (flat with skills/)
   - Pattern 3: `<domain>/<plugin>/skills/<skill>/SKILL.md` (nested plugin)
   Dedupes by SKILL.md path.
3. `sync_skill()` now creates RELATIVE symlinks (via os.path.relpath)
   instead of absolute. Critical for committed .hermes/ tree to work
   across machines. Falls back to absolute if cross-device.

**.hermes/skills/claude-skills/ tree committed:**

- 289 relative symlinks across 12 domains
- skills-index.json (303 skills documented with descriptions)
- All v2.7.0 skills present: productivity (4), marketing (1),
  research (8)

**Documentation refresh:**

- docs/integrations.md:
  - Header count: 246 → 311 skills
  - Hermes section: NEW "Tier: BYO-sync" tip box explaining the
    pre-generated tree + the one-line install step
  - Install table: "198+ skills" → "303 skills (12 domains)"
- README.md:
  - Hermes Agent entry in "Works with:" line now flagged with [^hermes]
    footnote explicitly labeling it BYO-sync tier with link to the
    sync script

Verification:
- Script smoke-test: `python3 sync-hermes-skills.py --target .hermes/skills --verbose`
  → 303 skills discovered, 289 new symlinks, 14 skipped (pre-existing)
- All v2.7.0 symlinks resolve correctly:
  `.hermes/skills/claude-skills/research/research → ../../../../research/research/skills/research`
- 12 domains present in tree (was 9 before)

Per CLAUDE.md ClawHub rules: this PR does NOT update marketplace.json
(Hermes is not on ClawHub). The .hermes/ tree is repo-side
infrastructure only.

https://claude.ai/code/session_01FEUmeuYhmnxVFq7EZM8ZSw
 2026-05-17 05:47:32 +00:00
Claude
1872ed0e61
fix(docs): plugins page — refresh stale counts to v2.7.0 reality 
The docs/plugins/index.md page was severely outdated, still showing
v2.1.x-era counts: 28 plugins, 9 domains, 177 skills, with a hardcoded
list of 10 standalone plugins. Missed entirely during PR #675's v2.7.0
docs sweep because it wasn't on the 7-step pipeline checklist.

Refreshed all numbers + content to current marketplace.json reality:
- 28 → 55 plugins
- 9 → 12 domains (added Productivity, Marketing top-level, Research)
- 177 → 311 skills
- v2.1.2 → v2.7.0 (Plugin Structure example + FAQ)

Plugin Architecture mermaid:
- Updated total to 55 plugins
- Added "v2.7.0 New Plugins" subgraph (12 standalone: 3 productivity,
  1 marketing, 8 research incl. orchestrator)
- Renamed "Standalone (10)" → "Other Standalone (46 total)"

Content additions:
- New section: "v2.7.0 Standalone Plugins ✨" with 3 sub-tables
  (Productivity / Marketing / Research) — all 12 new plugins with
  install commands and one-line descriptions
- "Other Standalone Plugins" — now a programmatically-generated table
  of 34 non-v2.7.0 standalones grouped by category (was hardcoded list
  of 10 — many obsolete: content-creator, demand-gen, fullstack-engineer,
  aws-architect, product-manager were never in marketplace.json)
- "All 55 Plugins at a Glance" — full table from marketplace.json data,
  marks v2.7.0 entries with ✨

Domain Bundles section:
- Skill counts refreshed (engineering-skills 24→32, marketing-skills
  43→44, ra-qm-skills 12→14, product-skills 12→13, pm-skills 6→9,
  business-growth-skills 4→5, finance-skills 2→3)
- Engineering POWERFUL bundle now mentions 4 Matt Pocock skills
- C-Level Advisory bundle now mentions all 14 C-suite roles (was 9)
- RA/QM bundle now mentions EU AI Act + ISO 42001

FAQ additions:
- "What are the v2.7.0 plugins?" — explains the 12 new plugin scope
- "What is the research orchestrator?" — explains hybrid router pattern
  + distinct_from autoresearch-agent disambiguation

Plugin Structure section:
- Added documentation of the two approved extension fields per
  CLAUDE.md ClawHub rule #5: `source` (Path-B provenance) and
  `attribution` (MIT external derivatives)

Verification:
- MkDocs build PASSES (no plugins-related errors or warnings)
- 0 stale references remaining (28 plugins, 9 Domains, 177 Skills,
  v2.1.2 all cleaned)
- 464 lines, 22 sections, all 55 plugins now represented

https://claude.ai/code/session_01FEUmeuYhmnxVFq7EZM8ZSw
 2026-05-16 21:49:55 +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
5c90482a45
fix(docs): re-remove ra-qm-team dual-publish duplicates 
generate-docs.py re-created these dual-publish duplicates that PR #644
removed. The v2.5.7 dedup logic in generate-docs.py covers the engineering/
domain but doesn't catch the ra-qm-team pattern. Tracked as separate
generator improvement (v2.6.x candidate).

https://claude.ai/code/session_01VFreMf7XLBqMgjsrG4wSYe
 2026-05-14 10:42:06 +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
bbe65c0936
docs: polish nav + clear 33 mkdocs INFO warnings 
Two small polish tasks ahead of any future Pages deploy.

1. Add /cs:* command nav entries (22 new entries)

The 21 c-level-agents-* sub-skill pages now exist (since #632) but weren't
surfaced in mkdocs.yml sidebar nav. Added a "Founder-Mode Commands" nested
section under C-Level Advisory with:
  - c-level-agents index
  - 10 forcing-question reviews (/cs:cfo-review through /cs:vpe-review)
  - 5 strategic sprint pipeline commands (brief/boardroom/decide/execute/post-mortem)
  - 4 meta+safety commands (founder-mode/onboard/cross-eval/freeze)
  - /cs:office-hours

2. Clear 33 mkdocs INFO warnings

mkdocs build was emitting 33 INFO-level warnings during the docs deploy.
Pre-existing noise; not regressions. Three categories:

a) 27 unrecognized-link warnings: relative links like `[Skills](skills/)`
   that mkdocs flags because the path doesn't end in .md. Fix: added
   explicit `index.md` suffix in 3 manual doc files.
     - docs/index.md: 15 links
     - docs/skills/index.md: 11 links
     - docs/custom-gpts.md: 1 link

b) 2 anchor warnings in scrum-master TOC: links pointed to
   `#analysis-tools--usage` and `#key-metrics--targets` (double hyphen
   from ampersand) but mkdocs Material's slugify produces single-hyphen
   slugs. Fix: changed to `#analysis-tools-usage` and `#key-metrics-targets`.

c) 4 anchor warnings in senior-computer-vision + senior-data-engineer TOCs:
   links pointed to non-existent sections.
   - senior-computer-vision: `#common-commands` TOC entry — no such heading
     anywhere; removed the entry.
   - senior-data-engineer: 3 sub-bullets pointing to `#workflow-1-...`,
     `#workflow-2-...`, `#workflow-3-...` — no such headings (only a
     parent `## Workflows`); removed the sub-bullets.

Verification:
- mkdocs build now emits 0 INFO warnings
- karpathy diff_surgeon: 0 findings on staged diff
- All 22 new nav entries verified to point to existing HTML pages
- generate-docs.py re-run picked up the upstream SKILL.md fixes; docs/skills/
  now matches sources

10 files changed, +54/-39. After the next dev->main release, the Pages
deploy will have:
- Cleaner build output (no INFO noise)
- Fully discoverable /cs:* command pages in the sidebar nav

https://claude.ai/code/session_012WtZMm5NJHqkYoRqA9fHMN
 2026-05-13 14:14:45 +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
17db1cc594
fix(docs): walk plugin-internal agents folders to fix 13 broken cs-* nav 404s 
PR #628 added 13 new cs-* agent nav entries to mkdocs.yml (cs-cfo-advisor,
cs-cmo-advisor, cs-cro-advisor, cs-cpo-advisor, cs-coo-advisor, cs-chro-advisor,
cs-ciso-advisor, cs-chief-of-staff, cs-general-counsel-advisor, cs-cdo-advisor,
cs-caio-advisor, cs-cco-advisor, cs-vpe-advisor) — but the agent pages they
pointed to didn't exist because generate-docs.py only walked /agents/, not
plugin-internal <domain>/<plugin>/agents/ folders.

Without this fix, those 13 nav links would 404 in production.

Extended generate-docs.py:

Pass 1 (existing): walk /agents/<domain>/*.md (28 canonical agents)
Pass 2 (new): walk <domain>/<plugin>/agents/*.md for each known DOMAINS root

Pass 2 dedupes against pass 1 by slug. Uses a SKILL_TO_AGENT_DOMAIN mapping
(c-level-advisor -> c-level, marketing-skill -> marketing, etc.) since skill
DOMAINS keys differ from AGENT_DOMAINS keys.

Result: 29 → 54 agent pages (+25 plugin-internal agents recovered):

  c-level-advisor/c-level-agents/agents/  → 13 new cs-* agents (this session)
  c-level-advisor/executive-mentor/agents/ → devils-advocate
  engineering/llm-wiki/agents/             → wiki-linter, wiki-ingestor, wiki-librarian
  engineering/agenthub/agents/             → hub-coordinator
  engineering/autoresearch-agent/agents/   → experiment-runner
  engineering-team/self-improving-agent/agents/ → memory-analyst, skill-extractor,
                                                  migration-planner, test-architect,
                                                  test-debugger

Verified:
- mkdocs build succeeds (357 → 380+ HTML pages)
- All 13 cs-* nav entries from PR #628 now resolve to valid HTML pages
- karpathy diff_surgeon: 0 findings
- Existing /agents/ canonical pass unaffected (dedupe by slug)

After dev → main release: GitHub Pages deploy will surface the recovered
25 agent pages. The 13 cs-* nav entries from the v2.5.7 release will no
longer 404.

https://claude.ai/code/session_012WtZMm5NJHqkYoRqA9fHMN
 2026-05-13 09:46:54 +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
a97eed2bc3
fix(docs): pass-2 count corrections — marketplace registry + integrations page 
PR #608 fixed the 5 most visible files but I missed three spots on the
first pass. Per the user's review request, this finishes the job by
applying ground-truth file-system counts to:

1. docs/integrations.md:8 — 'All 235 skills' → 'All 246 skills'
   (current-state claim, was stale)

2. .claude-plugin/marketplace.json (the public registry shown in
   plugin UIs) — both `description` and `metadata.description`:
   - headline:  188 → 246
   - agents:    '30 agents' → '27 agents (20 cs-* + 7 personas)'
   - per-domain breakdown rewritten from per-domain `find SKILL.md`:
       marketing-skill           44 → 45
       engineering (advanced)    40 → 67 unique (71 raw − 4 dist dupes)
       engineering-team (core)   32 → 51
       c-level-advisor           28 → 34
       ra-qm-team                14   ✓ (unchanged)
       product-team              13 → 17
       project-management         9   ✓ (unchanged)
       business-growth            5   ✓ (unchanged)
       finance                    3 → 4

   Per-domain sum 67+51+45+34+17+14+9+5+4 = 246 — matches headline.

Deliberately NOT changed:
- CLAUDE.md:143 ('235 total skills...') — that line is inside the
  v2.3.0 Highlights block. 235 was correct at the v2.3.0 release;
  it's a historical release snapshot, not a current-state claim, so
  rewriting it would falsify history.

Reproduce per-domain counts:
  for d in marketing-skill engineering engineering-team c-level-advisor \
           ra-qm-team product-team project-management business-growth finance; do
    printf '%-22s %3d\n' "$d" "$(find "$d" -name SKILL.md | wc -l)"
  done

Verified:
  - python3 -m json.tool .claude-plugin/marketplace.json → valid
  - 33 plugins confirmed in marketplace.json
  - grep sweep for '188 skill|Skills-188|Personas-3|30 agents|Agents-30|235 skill' → 0 hits
 2026-05-11 06:20:39 +00:00
Claude
be5df62183
fix(docs): align all repo metric claims to ground-truth file-system counts 
PR #607 shipped '188 skills, 30 agents, 3 personas, 30 marketplace plugins'
based on a stale codex-sync output that I trusted without verifying. The
actual file-system counts are:

  Skills:    246 (250 SKILL.md files; 4 deduped because chaos-engineering,
                  feature-flags-architect, kubernetes-operator and
                  slo-architect each ship as both an umbrella entry and
                  a standalone plugin)
  Tools:     359 .py files under */scripts/* (unchanged, was correct)
  Refs:      485 .md files under */references/* (unchanged, was correct)
  Agents:    27  (20 canonical cs-*-prefixed + 7 personas; excludes
                  agents/CLAUDE.md, personas/README.md, personas/TEMPLATE.md)
  Commands:  33  .md files under commands/ (unchanged, was correct)
  Plugins:   33  in .claude-plugin/marketplace.json (was '30' in the
                  Status line and README badge area)

Every number now reproduces from a single deterministic command:

  find . -name SKILL.md -not -path './.gemini/*' -not -path './.codex/*' \
       -not -path './site/*' -not -path './docs/*' \
       -not -path './.git/*' | wc -l           # -> 250 raw
  find agents -name 'cs-*.md' | wc -l          # -> 20 cs-* agents
  ls agents/personas/*.md | grep -v -E 'README|TEMPLATE' | wc -l  # -> 7
  python3 -c "import json; print(len(json.load(open('.claude-plugin/marketplace.json'))['plugins']))"  # -> 33

Surgical edits only: changed the number, left every other word in place.

Files touched: CLAUDE.md (7 lines), README.md (5 lines), docs/index.md
(4 lines), docs/getting-started.md (2 lines), mkdocs.yml (1 line).
 2026-05-10 10:08:23 +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
Claude
d4451f56d9
docs(site): update MkDocs site counts and nav for v2.4.4 
- docs/index.md: title, description, hero, grid cards (188/30/359/33)
- docs/getting-started.md: install description, FAQ count, tools claim
- mkdocs.yml: site_description count, nav entry for ship-gate
 2026-05-10 07:20:54 +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
0f255f36a9 feat(project-management): add meeting-analyzer and team-communications skills 
Based on PR #438 by maximcoding. Enhanced with anti-patterns, cross-references,
attribution, and renamed examples/ → references/.

meeting-analyzer (254 lines):
- Transcript analysis: speaking dynamics, conflict detection, filler words,
  decision patterns, facilitation quality, active listening
- Supports .txt, .md, .vtt, .srt, .docx, .json formats
- Trend tracking across multiple meetings

team-communications (67 lines + 4 reference templates):
- Internal comms: 3P updates, newsletters, FAQ roundups, general comms
- 4 reference templates with exact formatting guides
- MCP integration (Slack, Gmail, Drive, Calendar) when available

Co-Authored-By: maximcoding <maximcoding@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-31 15:06:26 +02:00
Reza Rezvani
3cd885aa33 chore: sync indexes, update marketplace and docs for 4 new community skills 
- Codex CLI: 182 skills, 4 new symlinks
- Gemini CLI: 274 items, 4 new
- engineering plugin.json: 36→38
- finance plugin.json: 2→3
- marketing plugin.json: 43→44
- marketplace.json: updated 3 bundle descriptions
- mkdocs.yml: 4 new nav entries
- docs/index.md + getting-started.md: domain counts updated
- 273 docs pages generated

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-31 12:32:57 +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
6fa92054bd
release(v2.2.0): 223 skills, security suite, self-eval, full docs update 
- Add 8 new skills: 6 security (adversarial-reviewer, ai-security, cloud-security, incident-response, red-team, threat-detection), self-eval, snowflake-development
- Update all counts: 223 skills, 298 tools, 416 references, 23 agents, 22 commands
- Update CHANGELOG.md with v2.2.0 entry
- Update all plugin.json versions to 2.2.0
- Update CLAUDE.md, README.md, docs/index.md, docs/getting-started.md, mkdocs.yml
- Verify MkDocs build (301 pages), Codex/Gemini sync, all new scripts pass --help

https://claude.ai/code/session_011CHSDjqWBPRcEJ3oJrAUHS
 2026-03-31 05:55:51 +00: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
Claude
01f7ee22c9
feat(adversarial-reviewer): audit fixes + full ecosystem integration 
- Enriched SKILL.md frontmatter (tier, category, dependencies, author, version)
- Added Description, Features, Usage, Examples sections for validator compliance
- Fixed cross-reference path (engineering/code-reviewer → engineering-team/code-reviewer)
- Updated domain plugin.json count (30→31)
- Added mkdocs.yml nav entry
- Synced Codex, Gemini indexes
- Generated docs page

https://claude.ai/code/session_01XY4i7SR4BHLWJpdjwGnNLG
 2026-03-30 19:08:14 +00:00
Reza Rezvani
478218e313 style(docs): improve visual design — hero, cards, buttons, typography, spacing 
1. Hero section: larger (max-width 800px), bigger heading (3rem), subtle
   background gradient, increased padding, social proof slot
2. Section spacing: h2 bottom borders, 2.5rem top margin, hr 3rem margin,
   alternating section backgrounds on homepage
3. Cards: background color, subtle default shadow, lift on hover (translateY),
   border highlights primary color on hover
4. Typography: base 0.78→0.82rem, h2 larger (1.4em) with 700 weight
5. Buttons: larger (0.9rem, more padding), 8px radius, primary shadow,
   lift on hover for both primary and outline
6. Mobile: responsive hero adjustments for smaller screens

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-26 13:21:50 +01:00
Reza Rezvani
070292bc27 docs: update all documentation for snowflake-development (29→30) 
- CLAUDE.md: engineering-team 29→30
- engineering-team/CLAUDE.md: add snowflake-development, 29→30
- marketplace.json: engineering-skills 29→30
- docs/getting-started.md: Engineering Core bundle 29→30
- docs/index.md: Engineering Core card 29→30

Official skill count remains 205.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-26 10:32:43 +01:00
Reza Rezvani
0e97512a42 feat(engineering-team): add snowflake-development skill 
Snowflake SQL, data pipelines (Dynamic Tables, Streams+Tasks), Cortex AI,
Snowpark Python, dbt integration. Includes 3 practical workflows, 9
anti-patterns, cross-references, and troubleshooting guide.

- SKILL.md: 294 lines (colon-prefix rule, MERGE, DTs, Cortex AI, Snowpark)
- Script: snowflake_query_helper.py (MERGE, DT, RBAC generators)
- References: 3 files (SQL patterns, Cortex AI/agents, troubleshooting)

Based on PR #416 by James Cha-Earley — enhanced with practical workflows,
anti-patterns section, cross-references, and normalized frontmatter.

Co-Authored-By: James Cha-Earley <jamescha-earley@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-26 09:38:57 +01:00
Reza Rezvani
c6206efc49 docs: update all documentation files with sprint skill counts 
- CLAUDE.md: engineering-team 26→29, engineering 30→35, ra-qm 12→13
- engineering-team/CLAUDE.md: add azure-cloud-architect, gcp-cloud-architect, security-pen-testing
- ra-qm-team/CLAUDE.md: add soc2-compliance (12→13)
- docs/getting-started.md: update Available Bundles table
- docs/index.md: update domain skill count cards

Official skill count remains 205.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-25 17:52:05 +01: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
Alireza Rezvani
ea2b33ab52
Merge pull request #407 from alirezarezvani/feature/sprint-phase-2-cloud 
feat(engineering-team): add azure-cloud-architect, security-pen-testing; extend terraform-patterns
 2026-03-25 14:22:01 +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
2056ba251f feat(engineering-team): add azure-cloud-architect, security-pen-testing; extend terraform-patterns 
azure-cloud-architect (451-line SKILL.md, 3 scripts, 3 references):
- 6-step workflow mirroring aws-solution-architect for Azure
- Bicep/ARM templates, AKS, Functions, Cosmos DB, cost optimization
- architecture_designer.py, cost_optimizer.py, bicep_generator.py

security-pen-testing (850-line SKILL.md, 3 scripts, 3 references):
- OWASP Top 10 systematic audit, offensive security testing
- XSS/SQLi/SSRF/IDOR detection, secret scanning, API security
- vulnerability_scanner.py, dependency_auditor.py, pentest_report_generator.py
- Responsible disclosure workflow included

terraform-patterns extended (487 → 740 lines):
- Multi-cloud provider configuration
- OpenTofu compatibility notes
- Infracost integration for PR cost estimation
- Import existing infrastructure patterns
- Terragrunt DRY multi-environment patterns

Updated engineering-team plugin.json (26 → 28 skills).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-25 13:32:22 +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
9de1c33474 fix(seo): add Google Search Console verification file to docs 
The GSC verification HTML file existed locally but was never committed,
so it was never deployed to GitHub Pages. This caused GSC to fail
reading the sitemap for 3+ weeks ("Sitemap konnte nicht gelesen werden").

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-23 12:57:12 +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
90cef3b3ac feat(commands): add /seo-auditor — 7-phase SEO audit pipeline for documentation 
- 7 phases: discovery → meta tags → content quality → keywords → links → sitemap → report
- Integrates 8 marketing-skill scripts: seo_checker, content_scorer,
  humanizer_scorer, headline_scorer, seo_optimizer, sitemap_analyzer,
  schema_validator, topic_cluster_mapper
- References 6 SEO knowledge bases for audit framework, AI search,
  content optimization, URL design, internal linking, AI detection
- Auto-fixes: generic titles, missing descriptions, broken links, orphan pages
- Preserves high-ranking pages — only fixes critical issues on those
- Registered in both commands/ (distributable) and .claude/commands/ (local)

Also: sync all doc counts — 28 plugins, 26 eng-core skills, 21 commands

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-18 10:28:17 +01:00