Commit graph

44 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
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
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
d692bf8dfd
Merge remote-tracking branch 'origin/dev' into claude/andreessen-productivity-plugin-PlOzn
# Conflicts:
#	.claude-plugin/marketplace.json
#	.gemini/skills-index.json
#	docs/getting-started.md
#	docs/index.md
#	mkdocs.yml
2026-05-24 01:56:01 +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
84980d5837
Merge branch 'dev' into claude/issue-705-W0aGU
Resolves PR #733 merge conflicts after dev advanced 11 commits (handoff
v2.8.2 fix #731, code-reviewer C#/.NET delivery #730, doc regenerations
#729, branch cleanup #721).

Conflict resolution strategy: take the union — keep dev's updated
counts (329 skills / 49+ agents / 79+ commands) AND my Mistral Vibe
additions (13 tools, named platform list).

Conflicts resolved:
- CHANGELOG.md — [Unreleased] Mistral Vibe entry placed above the
  v2.8.2 productivity/handoff entry.
- mkdocs.yml — site_description combines dev's 329/49+/79+ counts +
  v2.8.2 mentions with my 13-tools platform list.
- docs/index.md — title "329 Agent Skills", description merges dev's
  v2.8.2 / v2.8.1 / v2.8.0 highlights with Hermes Agent + Mistral
  Vibe in install list.
- docs/getting-started.md — description: 329 skills, 13 tools, Vibe
  included in setup list.
- docs/commands/index.md — bumped to 74 commands (dev's count) and
  kept dev's wording.

Post-merge index refresh:
- python3 scripts/sync-vibe-skills.py → 322 skills (was 320; +2 for
  handoff and claude-coach from dev)
- python3 scripts/sync-codex-skills.py → 322 skills
- python3 scripts/sync-gemini-skills.py → 393 items, 1 new
- python3 -m mkdocs build → PASS (515 HTML pages, was 513)
2026-05-23 02:20:09 +00:00
Claude
5c539e30df
docs(vibe): run /update-docs sync pipeline for Mistral Vibe integration
Mirrors the Hermes integration's documentation footprint across the
generated docs site and the marketplace manifest. Also picks up a few
post-v2.8.1 doc-generator outputs that hadn't been committed.

Changes:
- .claude-plugin/marketplace.json — Mistral Vibe added to platform
  compatibility tagline (12 → 13 tools).
- mkdocs.yml — site_description updated 12 → 13 AI coding tools, all 13
  named explicitly (Claude Code · Codex · Gemini · Hermes · Mistral Vibe
  · OpenClaw · Cursor · Aider · Windsurf · Kilo Code · OpenCode ·
  Augment · Antigravity).
- docs/index.md — description meta updated, two install-tab references
  added (Mistral Vibe tab + Mistral Vibe in install tools list),
  stale "12 AI coding tools" → "13" stat card.
- docs/getting-started.md — description meta updated, Mistral Vibe
  install tab added with --domain / --copy / --dry-run / --target flags.
- docs/integrations.md — Mistral Vibe card added to landing grid; new
  full Mistral Vibe section (~130 lines) parallel to the Hermes
  section: discovery paths, install steps, "what works" matrix, verify
  + update + troubleshooting blocks. Scoped to facts verifiable from
  the official Vibe docs.
- docs/agents/, docs/commands/, docs/skills/engineering-team/senior-* —
  regenerated by scripts/generate-docs.py (picks up v2.8.1 senior-*
  engineering skill upgrades that hadn't been re-generated yet).

Verification:
- python3 -m mkdocs build → PASS (20.56s, 513 HTML pages)
- Count consistency across README / CHANGELOG / marketplace / docs/* /
  mkdocs.yml → all read "13 AI coding tools" after fixing one stale
  "12" in docs/index.md
- scripts/sync-vibe-skills.py --help → exits 0
- bash -n scripts/vibe-install.sh → syntax OK
2026-05-23 02:14:10 +00:00
Claude
bdc043776c
fix(version): productivity/handoff is v2.8.2, not v2.8.1 (collision fix)
v2.8.1 was already taken by the engineering role-skill upgrade
(senior-fullstack / senior-frontend / senior-backend with karpathy-coder
+ Matt Pocock decision engines), released 2026-05-20 — before the
handoff PRs even merged. The auto-release workflow created the v2.8.1
tag from that work via CHANGELOG.md parsing.

The productivity/handoff skill is the next minor on top of v2.8.1:
v2.8.2.

Changes:

- CHANGELOG.md: prepend a new [2.8.2] entry documenting the handoff
  skill (PRs #724, #728, #729). The auto-release workflow
  (.github/workflows/release.yml) will pick up this entry and create
  the v2.8.2 git tag + GitHub Release on the next push to main.
- productivity/handoff/.claude-plugin/plugin.json: 2.8.1 -> 2.8.2
- .claude-plugin/marketplace.json (handoff entry): 2.8.1 -> 2.8.2
- CLAUDE.md: 4 spots bumped to v2.8.2; v2.8.1 references kept where
  they correctly point to the engineering role-skill release
- README.md: Productivity table row v2.8.1 -> v2.8.2
- docs/index.md: description, hero subtitle, "329 Skills" card text
- docs/getting-started.md: description meta + FAQ count text
- mkdocs.yml: site_description

The narrative across all top-level docs now reads correctly:
v2.8.0 (bizops + commercial) -> v2.8.1 (engineering role-skills) ->
v2.8.2 (productivity/handoff).

Verified:
- 0 v2.7.5 references remain (earlier typo)
- All v2.8.1 references that remain point to engineering role-skills
- CHANGELOG topmost entry: [2.8.2] - 2026-05-23
- plugin.json + marketplace.json both at 2.8.2
- mkdocs build clean (will re-verify in CI)

https://claude.ai/code/session_01KLhHBAfEDXdQMeRe6G8sRa
2026-05-23 01:43:50 +00:00
Claude
73645c800d
docs: bump productivity/handoff to v2.8.1 across all version references
Correct the version number from v2.7.5 to v2.8.1. The handoff skill is a
single-skill point release on top of v2.8.0 (business-operations +
commercial), not a v2.7.x backport.

Version touched in 7 files:
- productivity/handoff/.claude-plugin/plugin.json: 2.7.5 -> 2.8.1
- .claude-plugin/marketplace.json (handoff entry): 2.7.5 -> 2.8.1
- CLAUDE.md: Current Scope text, Current Version section header,
  v2.7.5 highlights -> v2.8.1 highlights, master plan reference,
  footer Version
- README.md: badges (Skills 313->329, Agents 46+->49+, Commands
  60+->79+), Productivity row in Skills Overview table (4 -> 5
  skills, v2.7.0 -> v2.8.1, add handoff)
- docs/index.md: title (313 -> 329), description (add v2.8.1 +
  v2.8.0 context), hero subtitle, "329 Skills" card text +
  "49+ Agents" card label
- docs/getting-started.md: description (313 -> 329, v2.7.3 -> v2.8.1
  context), FAQ "All 313 skills" -> "All 329 skills"
- mkdocs.yml: site_description (counts + v2.8.1/v2.8.0 context)

Verified:
- 0 remaining v2.7.5 references in tracked .md/.json/.yml files
- plugin.json + marketplace versions match (2.8.1)
- check_plugin_json.py OK on productivity/handoff
- mkdocs build clean (21.21s, pre-existing grill-with-docs warnings only)
- Codex + Gemini sync clean

https://claude.ai/code/session_01KLhHBAfEDXdQMeRe6G8sRa
2026-05-23 01:36:26 +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
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
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
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
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
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
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
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
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
Alireza Rezvani
5adbfdce47
release: sync dev → main — a11y-audit, /seo-auditor, /plugin-audit, 28 plugins (#380)
* fix: add missing plugin.json files and restore trailing newlines

- Add plugin.json for review-fix-a11y skill
- Add plugin.json for free-llm-api skill
- Restore POSIX-compliant trailing newlines in JSON index files

* feat(engineering): add review-fix-a11y skill (WCAG 2.2 a11y audit + fix) (#375)

Adds review-fix-a11y (WCAG 2.2 a11y audit + fix) and free-llm-api skills.

Includes:
- review-fix-a11y: WCAG 2.2 audit workflow, a11y_audit.py scanner, contrast_checker.py
- free-llm-api: ChatAnywhere, Groq, Cerebras, OpenRouter, llm-mux, One API setup
- secret_scanner.py upgrade with secrets-patterns-db integration (1,600+ patterns)

Co-authored-by: ivanopenclaw223-alt <ivanopenclaw223-alt@users.noreply.github.com>

* chore: sync codex skills symlinks [automated]

* Revert "feat(engineering): add review-fix-a11y skill (WCAG 2.2 a11y audit + fix) (#375)"

This reverts commit 49c9f2109f.

* chore: sync codex skills symlinks [automated]

* Revert "feat(engineering): add review-fix-a11y skill (WCAG 2.2 a11y audit + fix) (#375)"

This reverts commit 49c9f2109f.

* feat(engineering-team): add a11y-audit skill — WCAG 2.2 accessibility audit & fix (#376)

Built from scratch (replaces reverted PR #375 contribution).

Skill package:
- SKILL.md: 1132 lines, 3-phase workflow (scan → fix → verify),
  per-framework fix patterns (React, Next.js, Vue, Angular, Svelte, HTML),
  CI/CD integration guide, 20+ issue type coverage
- scripts/a11y_scanner.py: static scanner detecting 20+ violation types
  across HTML/JSX/TSX/Vue/Svelte/CSS — severity-ranked, CI-friendly exit codes
- scripts/contrast_checker.py: WCAG contrast calculator with AA/AAA checks,
  --suggest mode, --batch CSS scanning, named color support
- references/wcag-quick-ref.md: WCAG 2.2 Level A/AA criteria table
- references/aria-patterns.md: ARIA roles, live regions, keyboard interaction
- references/framework-a11y-patterns.md: React, Vue, Angular, Svelte fix patterns
- assets/sample-component.tsx: sample file with intentional violations
- expected_outputs/: scan report, contrast output, JSON output samples
- /a11y-audit slash command, settings.json, plugin.json, README.md

Validation: 97.6/100 (EXCELLENT), quality 73.9/100 (B-), scripts 2/2 PASS

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* chore: sync codex skills symlinks [automated]

* docs: sync counts across all docs — 205 skills, 268 tools, 19 commands, 22 plugins

Update CLAUDE.md, README.md, docs/index.md, docs/getting-started.md,
mkdocs.yml, marketplace.json with consistent counts. Sync Gemini CLI
index with new skills (code-to-prd, plugin-audit).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat(marketplace): add 6 missing standalone plugins — total 22→28

Added to marketplace:
- a11y-audit (WCAG 2.2 accessibility audit)
- executive-mentor (adversarial thinking partner)
- docker-development (Dockerfile, compose, multi-stage)
- helm-chart-builder (Helm chart scaffolding)
- terraform-patterns (IaC module design)
- research-summarizer (structured research synthesis)

Also fixed version 1.0.0 → 2.1.2 on 4 plugin.json files
(executive-mentor, docker-development, helm-chart-builder, research-summarizer)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* 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>

* 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>

---------

Co-authored-by: Leo <leo@openclaw.ai>
Co-authored-by: ivanopenclaw223-alt <ivanopenclaw223@gmail.com>
Co-authored-by: ivanopenclaw223-alt <ivanopenclaw223-alt@users.noreply.github.com>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-18 13:03:48 +01:00
Alireza Rezvani
78360cb59e
Dev (#379)
* fix: add missing plugin.json files and restore trailing newlines

- Add plugin.json for review-fix-a11y skill
- Add plugin.json for free-llm-api skill
- Restore POSIX-compliant trailing newlines in JSON index files

* feat(engineering): add review-fix-a11y skill (WCAG 2.2 a11y audit + fix) (#375)

Adds review-fix-a11y (WCAG 2.2 a11y audit + fix) and free-llm-api skills.

Includes:
- review-fix-a11y: WCAG 2.2 audit workflow, a11y_audit.py scanner, contrast_checker.py
- free-llm-api: ChatAnywhere, Groq, Cerebras, OpenRouter, llm-mux, One API setup
- secret_scanner.py upgrade with secrets-patterns-db integration (1,600+ patterns)

Co-authored-by: ivanopenclaw223-alt <ivanopenclaw223-alt@users.noreply.github.com>

* chore: sync codex skills symlinks [automated]

* Revert "feat(engineering): add review-fix-a11y skill (WCAG 2.2 a11y audit + fix) (#375)"

This reverts commit 49c9f2109f.

* chore: sync codex skills symlinks [automated]

* Revert "feat(engineering): add review-fix-a11y skill (WCAG 2.2 a11y audit + fix) (#375)"

This reverts commit 49c9f2109f.

* feat(engineering-team): add a11y-audit skill — WCAG 2.2 accessibility audit & fix (#376)

Built from scratch (replaces reverted PR #375 contribution).

Skill package:
- SKILL.md: 1132 lines, 3-phase workflow (scan → fix → verify),
  per-framework fix patterns (React, Next.js, Vue, Angular, Svelte, HTML),
  CI/CD integration guide, 20+ issue type coverage
- scripts/a11y_scanner.py: static scanner detecting 20+ violation types
  across HTML/JSX/TSX/Vue/Svelte/CSS — severity-ranked, CI-friendly exit codes
- scripts/contrast_checker.py: WCAG contrast calculator with AA/AAA checks,
  --suggest mode, --batch CSS scanning, named color support
- references/wcag-quick-ref.md: WCAG 2.2 Level A/AA criteria table
- references/aria-patterns.md: ARIA roles, live regions, keyboard interaction
- references/framework-a11y-patterns.md: React, Vue, Angular, Svelte fix patterns
- assets/sample-component.tsx: sample file with intentional violations
- expected_outputs/: scan report, contrast output, JSON output samples
- /a11y-audit slash command, settings.json, plugin.json, README.md

Validation: 97.6/100 (EXCELLENT), quality 73.9/100 (B-), scripts 2/2 PASS

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* chore: sync codex skills symlinks [automated]

* docs: sync counts across all docs — 205 skills, 268 tools, 19 commands, 22 plugins

Update CLAUDE.md, README.md, docs/index.md, docs/getting-started.md,
mkdocs.yml, marketplace.json with consistent counts. Sync Gemini CLI
index with new skills (code-to-prd, plugin-audit).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Leo <leo@openclaw.ai>
Co-authored-by: ivanopenclaw223-alt <ivanopenclaw223@gmail.com>
Co-authored-by: ivanopenclaw223-alt <ivanopenclaw223-alt@users.noreply.github.com>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-18 08:59:29 +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
Leo
82eea60947 feat: Custom GPTs page, gitignore configs, SEO README, cross-references
- Gitignore individual GPT config files (custom-gpt/*-gpt.md) — instructions
  should not be publicly exposed
- Rewrite custom-gpt/README.md with SEO-optimized descriptions and live
  ChatGPT links for all 6 GPTs
- New docs page: docs/custom-gpts.md with grid cards, comparison table,
  and stats
- Add Custom GPTs to mkdocs.yml navigation
- Cross-reference Custom GPTs from:
  - Homepage (new grid card)
  - Getting Started (FAQ entry)
  - Personas page (try in ChatGPT callout)
  - Plugins page (FAQ entry)

Live GPT links:
- Solo Founder: chatgpt.com/g/g-69b315...
- SEO Audit Expert: chatgpt.com/g/g-69b3b0...
- Content Strategist: chatgpt.com/g/g-69b3af...
- Product Manager Toolkit: chatgpt.com/g/g-69b32c...
- Conversion Copywriter: chatgpt.com/g/g-69b327...
- CTO Advisor: chatgpt.com/g/g-69b326...
2026-03-13 10:08:22 +01:00
Leo
bd70015f60 docs: overhaul homepage with tools bar, tabbed install, and professional polish
- Replace text-only platform list with styled color-coded tool badges
- Each badge links to the relevant install section
- Add tabbed Quick Install section (Claude Code / Codex / Gemini / Cursor)
- Restructure 'What's Inside' grid: skills, agents, personas, orchestration, tools, plugins, commands, multi-tool
- Rename 'POWERFUL' to 'Advanced' in domain cards
- Add tools-bar CSS with per-tool brand colors and hover effects
- Mobile-responsive tool badges
- Broaden site_name: 'Agent Skills' (not just Claude Code)
- Fix edit_uri: edit/main/docs/ (was missing docs/ prefix)
- Build verified: 238 sitemap URLs, all new pages included
2026-03-12 18:47:42 +01:00
Leo
6449e1bb00 docs: add personas and orchestration to GitHub Pages site
- Add personas section with 3 persona pages (startup-cto, growth-marketer, solo-founder)
- Add orchestration page with 4 coordination patterns
- Add personas and orchestration cards to homepage
- Add personas and orchestration to navigation
- Update site description and hero text
- All numbers verified and consistent across README + docs
2026-03-12 18:39:43 +01:00
Alireza Rezvani
5df8928bc8
feat: multi-tool skill conversion (Cursor, Aider, Windsurf, etc.) (#326) (#327) (#329) (#330) 2026-03-11 18:09:06 +01:00
Reza Rezvani
e2fff2f8f2 docs: sync counts and regenerate pages for product team expansion
Update all documentation to reflect 177 skills, 254 tools, 357 references,
16 agents, and 17 commands. Add 4 new skill pages, 1 agent page, and
2 command pages to MkDocs site. Sync Codex (156) and Gemini (218) indexes.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 15:15:39 +01:00
Reza Rezvani
338830ffe8 feat(docs): add Plugins & Marketplace overview page
- Create comprehensive plugins page with all 19 plugins (9 domain bundles + 10 standalone)
- Include architecture diagram, compatibility matrix, install commands for all 4 platforms
- Add plugin structure docs, FAQ, and complete reference table
- Add Plugins nav tab in mkdocs.yml
- Add plugins stat card (19) to homepage grid

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 12:06:08 +01:00
Reza Rezvani
4e9f1d934d feat(engineering): add google-workspace-cli skill with 5 Python tools
New skill for Google Workspace administration via the gws CLI:
- SKILL.md with 4 workflows (Gmail, Drive/Sheets, Calendar, Security Audit)
- 5 stdlib-only Python scripts (doctor, auth setup, recipe runner, audit, analyzer)
- 3 reference docs, 2 asset files, 43 built-in recipes, 10 persona bundles
- cs-workspace-admin agent, /google-workspace slash command
- Standalone marketplace plugin entry with .claude-plugin/plugin.json
- Cross-platform sync (Codex CLI, Gemini CLI), MkDocs docs pages
- All documentation updated (173 skills, 250 tools, 15 agents, 15 commands)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 09:59:40 +01:00
Reza Rezvani
778ce17b68 docs: integrate x-twitter-growth across plugin ecosystem and documentation
- Sync Gemini CLI (208 items), verify Codex CLI (151 skills)
- Update marketplace.json: 151 packages, marketing 43, tools 245
- Update marketing plugin.json with X/Twitter growth, 43 skills
- Update CLAUDE.md, README.md, docs/index.md, getting-started.md counts
  (172 skills, 245 tools, 344 references)
- Add x-twitter-growth to marketing CLAUDE.md skill map
- Add x-twitter-growth docs page and mkdocs.yml nav entry
- Regenerate 207 MkDocs pages, build verified

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 08:15:28 +01:00
Reza Rezvani
cb3fa6b7ea feat: integrate saas-metrics-coach, add finance commands, remove seek-and-analyze-video
- Integrate saas-metrics-coach into cs-financial-analyst agent with SaaS health
  and unit economics workflows
- Add /financial-health and /saas-health slash commands
- Add /update-docs repo command for post-creation sync pipeline
- Remove seek-and-analyze-video skill (requires paid external API)
- Update all documentation (CLAUDE.md, README.md, docs site, marketplace)
- Sync Codex CLI (150 skills), Gemini CLI (207 items), fix count consistency
- Regenerate 206 MkDocs pages, fix docs/index.md meta 170→171,
  getting-started.md finance bundle 1→2

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 14:29:41 +01:00
Reza Rezvani
979a1cefc7 docs: add 14 agent pages, 12 command pages, update getting-started and index
- Extended generate-docs.py to auto-generate agent and command documentation pages
- Added extract_subtitle() for meaningful command descriptions in index
- Added Agents nav section (14 entries) and Commands nav section (12 entries) to mkdocs.yml
- Updated docs/index.md: 170 skills, 237 tools, 14 agents, 12 commands, Gemini CLI
- Updated docs/getting-started.md: Gemini CLI tab, 237 tools, fixed brand_voice path, new FAQs
- Regenerated all 203 docs pages (177 skills + 14 agents + 12 commands)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-10 09:54:53 +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
161cf52724 fix: hide edit icon on homepage
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-06 13:21:19 +01:00
Reza Rezvani
697ecd37c4 fix: redesign homepage using Material native grid cards
Replaces broken custom HTML divs with Material's built-in grid cards
pattern. Fixes layout issues: cards now render in proper 3-column grid,
stats row displays correctly, hero section centers properly.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-06 13:18:06 +01:00
Reza Rezvani
52e8fe1764 style: modern minimalistic design with dark-first theme
- Dark mode as default with smooth light mode toggle
- Inter + JetBrains Mono fonts for clean typography
- Custom CSS: gradient hero, domain card grid, stat counters, feature list
- Landing page redesigned with cards, CTAs, and visual hierarchy
- Getting started: tabbed install (Material tabs), numbered steps, collapsible FAQ
- MkDocs Material features: sticky tabs, instant navigation, progress bar,
  breadcrumbs, code annotations, emoji support, mermaid diagrams
- All Material reference extensions enabled (keys, mark, caret, tilde, etc.)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-06 12:47:56 +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