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
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
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
aeab2174d2
fix(docs): convert backtick relative paths to clickable GitHub links
...
Extend rewrite_relative_links() to also handle `../../path/to/file`
backtick code references, converting them to clickable links showing
parent/filename for context (e.g., product-analytics/SKILL.md).
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 15:27:32 +01:00
Reza Rezvani
d10d324d50
fix(docs): rewrite broken relative links in agent and command pages
...
Add rewrite_relative_links() to generate-docs.py that converts ../../
relative paths to absolute GitHub URLs. Sibling agent links (e.g.,
cs-foo.md → cs-bar.md) are preserved as local doc links. Regenerated
all agent pages with fixed references.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 15:25:31 +01:00
Reza Rezvani
670930c69d
feat(docs): implement unified design system across all generated pages
...
- Add CSS components: .page-meta badges, .domain-header, .install-banner
- Fix invisible tab navigation (explicit color for light/dark modes)
- Rewrite generate-docs.py with design system templates
- Domain indexes: centered headers with icons, install banners, grid cards
- Skill pages: pill badges (domain, skill ID, source), install commands
- Agent/command pages: type badges with domain icons
- Regenerate all 210 pages (180 skills + 15 agents + 15 commands)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 12:32:49 +01:00
Reza Rezvani
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
