From d10d324d50db12ad988b419c3394d6cd662b9117 Mon Sep 17 00:00:00 2001 From: Reza Rezvani Date: Wed, 11 Mar 2026 15:25:31 +0100 Subject: [PATCH] fix(docs): rewrite broken relative links in agent and command pages MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- docs/agents/cs-agile-product-owner.md | 10 +++---- docs/agents/cs-ceo-advisor.md | 10 +++---- docs/agents/cs-content-creator.md | 8 +++--- docs/agents/cs-cto-advisor.md | 10 +++---- docs/agents/cs-demand-gen-specialist.md | 8 +++--- docs/agents/cs-engineering-lead.md | 4 +-- docs/agents/cs-financial-analyst.md | 4 +-- docs/agents/cs-growth-strategist.md | 4 +-- docs/agents/cs-product-manager.md | 6 ++--- docs/agents/cs-product-strategist.md | 14 +++++----- docs/agents/cs-project-manager.md | 18 ++++++------- docs/agents/cs-quality-regulatory.md | 4 +-- docs/agents/cs-senior-engineer.md | 4 +-- docs/agents/cs-ux-researcher.md | 16 +++++------ docs/agents/cs-workspace-admin.md | 4 +-- scripts/generate-docs.py | 35 +++++++++++++++++++++++++ 16 files changed, 97 insertions(+), 62 deletions(-) diff --git a/docs/agents/cs-agile-product-owner.md b/docs/agents/cs-agile-product-owner.md index 9d96e0d..0e9320c 100644 --- a/docs/agents/cs-agile-product-owner.md +++ b/docs/agents/cs-agile-product-owner.md @@ -406,11 +406,11 @@ echo "Location: ../../product-team/agile-product-owner/references/user-story-tem ## References -- **Primary Skill:** [../../product-team/agile-product-owner/SKILL.md](../../product-team/agile-product-owner/SKILL.md) -- **RICE Framework:** [../../product-team/product-manager-toolkit/SKILL.md](../../product-team/product-manager-toolkit/SKILL.md) -- **Product Domain Guide:** [../../product-team/CLAUDE.md](../../product-team/CLAUDE.md) -- **Agent Development Guide:** [../CLAUDE.md](../CLAUDE.md) -- **Scrum Master Skill:** [../../project-management/scrum-master/SKILL.md](../../project-management/scrum-master/SKILL.md) +- **Primary Skill:** [../../product-team/agile-product-owner/SKILL.md](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/agile-product-owner/SKILL.md) +- **RICE Framework:** [../../product-team/product-manager-toolkit/SKILL.md](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-manager-toolkit/SKILL.md) +- **Product Domain Guide:** [../../product-team/CLAUDE.md](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/CLAUDE.md) +- **Agent Development Guide:** [../CLAUDE.md](https://github.com/alirezarezvani/claude-skills/tree/main/agents/CLAUDE.md) +- **Scrum Master Skill:** [../../project-management/scrum-master/SKILL.md](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/scrum-master/SKILL.md) --- diff --git a/docs/agents/cs-ceo-advisor.md b/docs/agents/cs-ceo-advisor.md index 4e6f2e1..8e0c918 100644 --- a/docs/agents/cs-ceo-advisor.md +++ b/docs/agents/cs-ceo-advisor.md @@ -346,14 +346,14 @@ esac ## Related Agents - [cs-cto-advisor](cs-cto-advisor.md) - Technology strategy and engineering leadership (CTO counterpart) -- [cs-product-manager](../product/cs-product-manager.md) - Product strategy and roadmap execution (planned) -- [cs-growth-strategist](../business-growth/cs-growth-strategist.md) - Growth strategy and market expansion (planned) +- [cs-product-manager](https://github.com/alirezarezvani/claude-skills/tree/main/agents/product/cs-product-manager.md) - Product strategy and roadmap execution (planned) +- [cs-growth-strategist](https://github.com/alirezarezvani/claude-skills/tree/main/agents/business-growth/cs-growth-strategist.md) - Growth strategy and market expansion (planned) ## References -- **Skill Documentation:** [../../c-level-advisor/ceo-advisor/SKILL.md](../../c-level-advisor/ceo-advisor/SKILL.md) -- **C-Level Domain Guide:** [../../c-level-advisor/CLAUDE.md](../../c-level-advisor/CLAUDE.md) -- **Agent Development Guide:** [../CLAUDE.md](../CLAUDE.md) +- **Skill Documentation:** [../../c-level-advisor/ceo-advisor/SKILL.md](https://github.com/alirezarezvani/claude-skills/tree/main/c-level-advisor/ceo-advisor/SKILL.md) +- **C-Level Domain Guide:** [../../c-level-advisor/CLAUDE.md](https://github.com/alirezarezvani/claude-skills/tree/main/c-level-advisor/CLAUDE.md) +- **Agent Development Guide:** [../CLAUDE.md](https://github.com/alirezarezvani/claude-skills/tree/main/agents/CLAUDE.md) --- diff --git a/docs/agents/cs-content-creator.md b/docs/agents/cs-content-creator.md index ac902f7..3f5fd6e 100644 --- a/docs/agents/cs-content-creator.md +++ b/docs/agents/cs-content-creator.md @@ -237,10 +237,10 @@ cat ../../marketing-skill/content-creator/references/analytics_guide.md ## References -- **Skill Documentation:** [../../marketing-skill/content-creator/SKILL.md](../../marketing-skill/content-creator/SKILL.md) -- **Marketing Domain Guide:** [../../marketing-skill/CLAUDE.md](../../marketing-skill/CLAUDE.md) -- **Agent Development Guide:** [../CLAUDE.md](../CLAUDE.md) -- **Marketing Roadmap:** [../../marketing-skill/marketing_skills_roadmap.md](../../marketing-skill/marketing_skills_roadmap.md) +- **Skill Documentation:** [../../marketing-skill/content-creator/SKILL.md](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/content-creator/SKILL.md) +- **Marketing Domain Guide:** [../../marketing-skill/CLAUDE.md](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/CLAUDE.md) +- **Agent Development Guide:** [../CLAUDE.md](https://github.com/alirezarezvani/claude-skills/tree/main/agents/CLAUDE.md) +- **Marketing Roadmap:** [../../marketing-skill/marketing_skills_roadmap.md](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/marketing_skills_roadmap.md) --- diff --git a/docs/agents/cs-cto-advisor.md b/docs/agents/cs-cto-advisor.md index 100b118..a400b9d 100644 --- a/docs/agents/cs-cto-advisor.md +++ b/docs/agents/cs-cto-advisor.md @@ -398,14 +398,14 @@ echo "- Process improvements identified" ## Related Agents - [cs-ceo-advisor](cs-ceo-advisor.md) - Strategic leadership and organizational development (CEO counterpart) -- [cs-fullstack-engineer](../engineering/cs-fullstack-engineer.md) - Fullstack development coordination (planned) -- [cs-devops-specialist](../engineering/cs-devops-specialist.md) - DevOps and infrastructure automation (planned) +- [cs-fullstack-engineer](https://github.com/alirezarezvani/claude-skills/tree/main/agents/engineering/cs-fullstack-engineer.md) - Fullstack development coordination (planned) +- [cs-devops-specialist](https://github.com/alirezarezvani/claude-skills/tree/main/agents/engineering/cs-devops-specialist.md) - DevOps and infrastructure automation (planned) ## References -- **Skill Documentation:** [../../c-level-advisor/cto-advisor/SKILL.md](../../c-level-advisor/cto-advisor/SKILL.md) -- **C-Level Domain Guide:** [../../c-level-advisor/CLAUDE.md](../../c-level-advisor/CLAUDE.md) -- **Agent Development Guide:** [../CLAUDE.md](../CLAUDE.md) +- **Skill Documentation:** [../../c-level-advisor/cto-advisor/SKILL.md](https://github.com/alirezarezvani/claude-skills/tree/main/c-level-advisor/cto-advisor/SKILL.md) +- **C-Level Domain Guide:** [../../c-level-advisor/CLAUDE.md](https://github.com/alirezarezvani/claude-skills/tree/main/c-level-advisor/CLAUDE.md) +- **Agent Development Guide:** [../CLAUDE.md](https://github.com/alirezarezvani/claude-skills/tree/main/agents/CLAUDE.md) --- diff --git a/docs/agents/cs-demand-gen-specialist.md b/docs/agents/cs-demand-gen-specialist.md index edd625b..b93f046 100644 --- a/docs/agents/cs-demand-gen-specialist.md +++ b/docs/agents/cs-demand-gen-specialist.md @@ -280,10 +280,10 @@ fi ## References -- **Skill Documentation:** [../../marketing-skill/marketing-demand-acquisition/SKILL.md](../../marketing-skill/marketing-demand-acquisition/SKILL.md) -- **Marketing Domain Guide:** [../../marketing-skill/CLAUDE.md](../../marketing-skill/CLAUDE.md) -- **Agent Development Guide:** [../CLAUDE.md](../CLAUDE.md) -- **Marketing Roadmap:** [../../marketing-skill/marketing_skills_roadmap.md](../../marketing-skill/marketing_skills_roadmap.md) +- **Skill Documentation:** [../../marketing-skill/marketing-demand-acquisition/SKILL.md](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/marketing-demand-acquisition/SKILL.md) +- **Marketing Domain Guide:** [../../marketing-skill/CLAUDE.md](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/CLAUDE.md) +- **Agent Development Guide:** [../CLAUDE.md](https://github.com/alirezarezvani/claude-skills/tree/main/agents/CLAUDE.md) +- **Marketing Roadmap:** [../../marketing-skill/marketing_skills_roadmap.md](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/marketing_skills_roadmap.md) --- diff --git a/docs/agents/cs-engineering-lead.md b/docs/agents/cs-engineering-lead.md index 3361a56..4692490 100644 --- a/docs/agents/cs-engineering-lead.md +++ b/docs/agents/cs-engineering-lead.md @@ -85,5 +85,5 @@ Engineering team lead coordinating across specializations: frontend, backend, QA ## Related Agents -- [cs-senior-engineer](../engineering/cs-senior-engineer.md) -- Architecture decisions, code review, and CI/CD pipeline setup -- [cs-product-manager](../product/cs-product-manager.md) -- Feature prioritization and requirements alignment +- [cs-senior-engineer](https://github.com/alirezarezvani/claude-skills/tree/main/agents/engineering/cs-senior-engineer.md) -- Architecture decisions, code review, and CI/CD pipeline setup +- [cs-product-manager](https://github.com/alirezarezvani/claude-skills/tree/main/agents/product/cs-product-manager.md) -- Feature prioritization and requirements alignment diff --git a/docs/agents/cs-financial-analyst.md b/docs/agents/cs-financial-analyst.md index 788a99a..1364680 100644 --- a/docs/agents/cs-financial-analyst.md +++ b/docs/agents/cs-financial-analyst.md @@ -109,5 +109,5 @@ python ../../finance/financial-analyst/scripts/dcf_valuation.py valuation_data.j ## Related Agents -- [cs-ceo-advisor](../c-level/cs-ceo-advisor.md) -- Strategic financial decisions, board reporting, and fundraising planning -- [cs-growth-strategist](../business-growth/cs-growth-strategist.md) -- Revenue operations data and pipeline forecasting inputs +- [cs-ceo-advisor](https://github.com/alirezarezvani/claude-skills/tree/main/agents/c-level/cs-ceo-advisor.md) -- Strategic financial decisions, board reporting, and fundraising planning +- [cs-growth-strategist](https://github.com/alirezarezvani/claude-skills/tree/main/agents/business-growth/cs-growth-strategist.md) -- Revenue operations data and pipeline forecasting inputs diff --git a/docs/agents/cs-growth-strategist.md b/docs/agents/cs-growth-strategist.md index d68a304..8cc6055 100644 --- a/docs/agents/cs-growth-strategist.md +++ b/docs/agents/cs-growth-strategist.md @@ -65,5 +65,5 @@ Growth-focused operator covering the full revenue lifecycle: pipeline management ## Related Agents -- [cs-product-manager](../product/cs-product-manager.md) -- Product roadmap alignment for sales positioning and feature prioritization -- [cs-financial-analyst](../finance/cs-financial-analyst.md) -- Revenue forecasting validation and financial modeling support +- [cs-product-manager](https://github.com/alirezarezvani/claude-skills/tree/main/agents/product/cs-product-manager.md) -- Product roadmap alignment for sales positioning and feature prioritization +- [cs-financial-analyst](https://github.com/alirezarezvani/claude-skills/tree/main/agents/finance/cs-financial-analyst.md) -- Revenue forecasting validation and financial modeling support diff --git a/docs/agents/cs-product-manager.md b/docs/agents/cs-product-manager.md index eaac553..56e8069 100644 --- a/docs/agents/cs-product-manager.md +++ b/docs/agents/cs-product-manager.md @@ -676,9 +676,9 @@ echo "Report: $QUARTER-roadmap.txt" ## References -- **Skill Documentation:** [../../product-team/product-manager-toolkit/SKILL.md](../../product-team/product-manager-toolkit/SKILL.md) -- **Product Domain Guide:** [../../product-team/CLAUDE.md](../../product-team/CLAUDE.md) -- **Agent Development Guide:** [../CLAUDE.md](../CLAUDE.md) +- **Skill Documentation:** [../../product-team/product-manager-toolkit/SKILL.md](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-manager-toolkit/SKILL.md) +- **Product Domain Guide:** [../../product-team/CLAUDE.md](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/CLAUDE.md) +- **Agent Development Guide:** [../CLAUDE.md](https://github.com/alirezarezvani/claude-skills/tree/main/agents/CLAUDE.md) --- diff --git a/docs/agents/cs-product-strategist.md b/docs/agents/cs-product-strategist.md index 964a3c8..7f6de00 100644 --- a/docs/agents/cs-product-strategist.md +++ b/docs/agents/cs-product-strategist.md @@ -471,17 +471,17 @@ python ../../product-team/product-strategist/scripts/okr_cascade_generator.py gr - [cs-product-manager](cs-product-manager.md) - Feature-level execution, RICE prioritization, PRD development - [cs-agile-product-owner](cs-agile-product-owner.md) - Sprint-level planning and backlog management - [cs-ux-researcher](cs-ux-researcher.md) - User research to validate strategic assumptions -- [cs-ceo-advisor](../c-level/cs-ceo-advisor.md) - Company-level strategic alignment +- [cs-ceo-advisor](https://github.com/alirezarezvani/claude-skills/tree/main/agents/c-level/cs-ceo-advisor.md) - Company-level strategic alignment - Senior PM Skill - Portfolio context (see `../../project-management/senior-pm/`) ## References -- **Primary Skill:** [../../product-team/product-strategist/SKILL.md](../../product-team/product-strategist/SKILL.md) -- **Competitive Teardown Skill:** [../../product-team/competitive-teardown/SKILL.md](../../product-team/competitive-teardown/SKILL.md) -- **OKR Framework:** [../../product-team/product-strategist/references/okr_framework.md](../../product-team/product-strategist/references/okr_framework.md) -- **Strategy Types:** [../../product-team/product-strategist/references/strategy_types.md](../../product-team/product-strategist/references/strategy_types.md) -- **Product Domain Guide:** [../../product-team/CLAUDE.md](../../product-team/CLAUDE.md) -- **Agent Development Guide:** [../CLAUDE.md](../CLAUDE.md) +- **Primary Skill:** [../../product-team/product-strategist/SKILL.md](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-strategist/SKILL.md) +- **Competitive Teardown Skill:** [../../product-team/competitive-teardown/SKILL.md](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/competitive-teardown/SKILL.md) +- **OKR Framework:** [../../product-team/product-strategist/references/okr_framework.md](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-strategist/references/okr_framework.md) +- **Strategy Types:** [../../product-team/product-strategist/references/strategy_types.md](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-strategist/references/strategy_types.md) +- **Product Domain Guide:** [../../product-team/CLAUDE.md](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/CLAUDE.md) +- **Agent Development Guide:** [../CLAUDE.md](https://github.com/alirezarezvani/claude-skills/tree/main/agents/CLAUDE.md) --- diff --git a/docs/agents/cs-project-manager.md b/docs/agents/cs-project-manager.md index 71a9cc4..92d71b0 100644 --- a/docs/agents/cs-project-manager.md +++ b/docs/agents/cs-project-manager.md @@ -497,19 +497,19 @@ echo "Template: ../../project-management/senior-pm/assets/executive_report_templ ## Related Agents -- [cs-product-manager](../product/cs-product-manager.md) -- Product prioritization with RICE, customer discovery, PRD development -- [cs-agile-product-owner](../product/cs-agile-product-owner.md) -- User story generation, backlog management, acceptance criteria (planned) +- [cs-product-manager](https://github.com/alirezarezvani/claude-skills/tree/main/agents/product/cs-product-manager.md) -- Product prioritization with RICE, customer discovery, PRD development +- [cs-agile-product-owner](https://github.com/alirezarezvani/claude-skills/tree/main/agents/product/cs-agile-product-owner.md) -- User story generation, backlog management, acceptance criteria (planned) - [cs-scrum-master](cs-scrum-master.md) -- Dedicated Scrum ceremony facilitation and team coaching (planned) ## References -- **Senior PM Skill:** [../../project-management/senior-pm/SKILL.md](../../project-management/senior-pm/SKILL.md) -- **Scrum Master Skill:** [../../project-management/scrum-master/SKILL.md](../../project-management/scrum-master/SKILL.md) -- **Jira Expert Skill:** [../../project-management/jira-expert/SKILL.md](../../project-management/jira-expert/SKILL.md) -- **Confluence Expert Skill:** [../../project-management/confluence-expert/SKILL.md](../../project-management/confluence-expert/SKILL.md) -- **Atlassian Admin Skill:** [../../project-management/atlassian-admin/SKILL.md](../../project-management/atlassian-admin/SKILL.md) -- **PM Domain Guide:** [../../project-management/CLAUDE.md](../../project-management/CLAUDE.md) -- **Agent Development Guide:** [../CLAUDE.md](../CLAUDE.md) +- **Senior PM Skill:** [../../project-management/senior-pm/SKILL.md](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/senior-pm/SKILL.md) +- **Scrum Master Skill:** [../../project-management/scrum-master/SKILL.md](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/scrum-master/SKILL.md) +- **Jira Expert Skill:** [../../project-management/jira-expert/SKILL.md](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/jira-expert/SKILL.md) +- **Confluence Expert Skill:** [../../project-management/confluence-expert/SKILL.md](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/confluence-expert/SKILL.md) +- **Atlassian Admin Skill:** [../../project-management/atlassian-admin/SKILL.md](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/atlassian-admin/SKILL.md) +- **PM Domain Guide:** [../../project-management/CLAUDE.md](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/CLAUDE.md) +- **Agent Development Guide:** [../CLAUDE.md](https://github.com/alirezarezvani/claude-skills/tree/main/agents/CLAUDE.md) --- diff --git a/docs/agents/cs-quality-regulatory.md b/docs/agents/cs-quality-regulatory.md index 9b9c39d..f9eed15 100644 --- a/docs/agents/cs-quality-regulatory.md +++ b/docs/agents/cs-quality-regulatory.md @@ -85,5 +85,5 @@ Regulatory affairs and quality management specialist for medical device and heal ## Related Agents -- [cs-engineering-lead](../engineering-team/cs-engineering-lead.md) -- Engineering process alignment for design controls and software validation -- [cs-product-manager](../product/cs-product-manager.md) -- Product requirements traceability and risk-benefit analysis coordination +- [cs-engineering-lead](https://github.com/alirezarezvani/claude-skills/tree/main/agents/engineering-team/cs-engineering-lead.md) -- Engineering process alignment for design controls and software validation +- [cs-product-manager](https://github.com/alirezarezvani/claude-skills/tree/main/agents/product/cs-product-manager.md) -- Product requirements traceability and risk-benefit analysis coordination diff --git a/docs/agents/cs-senior-engineer.md b/docs/agents/cs-senior-engineer.md index c4d077e..6574410 100644 --- a/docs/agents/cs-senior-engineer.md +++ b/docs/agents/cs-senior-engineer.md @@ -87,5 +87,5 @@ Cross-cutting senior engineer covering architecture, backend, DevOps, security, ## Related Agents -- [cs-engineering-lead](../engineering-team/cs-engineering-lead.md) -- Team coordination, incident response, and cross-functional delivery -- [cs-product-manager](../product/cs-product-manager.md) -- Feature prioritization and requirements context +- [cs-engineering-lead](https://github.com/alirezarezvani/claude-skills/tree/main/agents/engineering-team/cs-engineering-lead.md) -- Team coordination, incident response, and cross-functional delivery +- [cs-product-manager](https://github.com/alirezarezvani/claude-skills/tree/main/agents/product/cs-product-manager.md) -- Feature prioritization and requirements context diff --git a/docs/agents/cs-ux-researcher.md b/docs/agents/cs-ux-researcher.md index e040aa6..77e8509 100644 --- a/docs/agents/cs-ux-researcher.md +++ b/docs/agents/cs-ux-researcher.md @@ -518,14 +518,14 @@ echo "See: ../../product-team/ui-design-system/references/developer-handoff.md" ## References -- **Primary Skill:** [../../product-team/ux-researcher-designer/SKILL.md](../../product-team/ux-researcher-designer/SKILL.md) -- **Interview Analyzer:** [../../product-team/product-manager-toolkit/SKILL.md](../../product-team/product-manager-toolkit/SKILL.md) -- **Persona Methodology:** [../../product-team/ux-researcher-designer/references/persona-methodology.md](../../product-team/ux-researcher-designer/references/persona-methodology.md) -- **Journey Mapping Guide:** [../../product-team/ux-researcher-designer/references/journey-mapping-guide.md](../../product-team/ux-researcher-designer/references/journey-mapping-guide.md) -- **Usability Testing:** [../../product-team/ux-researcher-designer/references/usability-testing-frameworks.md](../../product-team/ux-researcher-designer/references/usability-testing-frameworks.md) -- **Design System:** [../../product-team/ui-design-system/SKILL.md](../../product-team/ui-design-system/SKILL.md) -- **Product Domain Guide:** [../../product-team/CLAUDE.md](../../product-team/CLAUDE.md) -- **Agent Development Guide:** [../CLAUDE.md](../CLAUDE.md) +- **Primary Skill:** [../../product-team/ux-researcher-designer/SKILL.md](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ux-researcher-designer/SKILL.md) +- **Interview Analyzer:** [../../product-team/product-manager-toolkit/SKILL.md](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-manager-toolkit/SKILL.md) +- **Persona Methodology:** [../../product-team/ux-researcher-designer/references/persona-methodology.md](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ux-researcher-designer/references/persona-methodology.md) +- **Journey Mapping Guide:** [../../product-team/ux-researcher-designer/references/journey-mapping-guide.md](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ux-researcher-designer/references/journey-mapping-guide.md) +- **Usability Testing:** [../../product-team/ux-researcher-designer/references/usability-testing-frameworks.md](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ux-researcher-designer/references/usability-testing-frameworks.md) +- **Design System:** [../../product-team/ui-design-system/SKILL.md](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ui-design-system/SKILL.md) +- **Product Domain Guide:** [../../product-team/CLAUDE.md](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/CLAUDE.md) +- **Agent Development Guide:** [../CLAUDE.md](https://github.com/alirezarezvani/claude-skills/tree/main/agents/CLAUDE.md) --- diff --git a/docs/agents/cs-workspace-admin.md b/docs/agents/cs-workspace-admin.md index d716229..b939258 100644 --- a/docs/agents/cs-workspace-admin.md +++ b/docs/agents/cs-workspace-admin.md @@ -155,9 +155,9 @@ gws helpers morning-briefing --json | python3 ../../engineering-team/google-work ## Related Agents - [cs-engineering-lead](cs-engineering-lead.md) — Engineering team coordination -- [cs-senior-engineer](../engineering/cs-senior-engineer.md) — Architecture and CI/CD +- [cs-senior-engineer](https://github.com/alirezarezvani/claude-skills/tree/main/agents/engineering/cs-senior-engineer.md) — Architecture and CI/CD ## References -- [Skill Documentation](../../engineering-team/google-workspace-cli/SKILL.md) +- [Skill Documentation](https://github.com/alirezarezvani/claude-skills/tree/main/engineering-team/google-workspace-cli/SKILL.md) - [gws CLI Repository](https://github.com/googleworkspace/cli) diff --git a/scripts/generate-docs.py b/scripts/generate-docs.py index d51ebfa..3b93cab 100644 --- a/scripts/generate-docs.py +++ b/scripts/generate-docs.py @@ -143,6 +143,39 @@ def strip_content(content): return content +GITHUB_BASE = "https://github.com/alirezarezvani/claude-skills/tree/main" + + +def rewrite_relative_links(content, source_rel_path): + """Rewrite relative markdown links (../../, ../) to absolute GitHub URLs. + + Agent and command source files use relative paths like ../../product-team/SKILL.md + which break when rendered in the docs site. Convert them to GitHub source links. + """ + source_dir = os.path.dirname(source_rel_path) + + def resolve_link(match): + text = match.group(1) + rel_target = match.group(2) + # Only rewrite relative paths that go up (../) + if not rel_target.startswith("../"): + return match.group(0) + # Resolve against source directory + resolved = os.path.normpath(os.path.join(source_dir, rel_target)) + # Keep links to sibling .md files in the same docs directory + # e.g. agents/product/cs-foo.md linking to cs-bar.md (same-level agent docs) + # These resolve to agents/product/cs-bar.md — only keep if they're + # a docs page we generate (agent .md that isn't CLAUDE.md) + if (resolved.startswith("agents/") and resolved.count("/") == 1 + and resolved.endswith(".md") and "CLAUDE" not in resolved): + # This is a sibling agent doc link — rewrite to flat docs slug + sibling = os.path.basename(resolved).replace(".md", "") + ".md" + return f"[{text}]({sibling})" + return f"[{text}]({GITHUB_BASE}/{resolved})" + + return re.sub(r"\[([^\]]+)\]\((\.\.[^\)]+)\)", resolve_link, content) + + def generate_skill_page(skill, domain_key): """Generate a docs page for a single skill.""" skill_md_path = skill["path"] @@ -349,6 +382,7 @@ description: "All {skill_count} {domain_name} skills for Claude Code, Codex CLI, content = f.read() content_clean = strip_content(content) + content_clean = rewrite_relative_links(content_clean, rel) page = f'''--- title: "{title}" @@ -424,6 +458,7 @@ description: "All {agent_count} Claude Code agents — multi-skill orchestrators content = f.read() content_clean = strip_content(content) + content_clean = rewrite_relative_links(content_clean, rel) page = f'''--- title: "/{cmd_name}"