diff --git a/docs/agents/cs-agile-product-owner.md b/docs/agents/cs-agile-product-owner.md
index 0e9320c..60b1aca 100644
--- a/docs/agents/cs-agile-product-owner.md
+++ b/docs/agents/cs-agile-product-owner.md
@@ -22,27 +22,27 @@ The cs-agile-product-owner agent bridges strategic product goals with sprint-lev
 
 ## Skill Integration
 
-**Primary Skill:** `../../product-team/agile-product-owner/`
+**Primary Skill:** [`product-team/agile-product-owner`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/agile-product-owner)
 
 ### All Orchestrated Skills
 
 | # | Skill | Location | Primary Tool |
 |---|-------|----------|-------------|
-| 1 | Agile Product Owner | `../../product-team/agile-product-owner/` | user_story_generator.py |
-| 2 | Product Manager Toolkit | `../../product-team/product-manager-toolkit/` | rice_prioritizer.py |
+| 1 | Agile Product Owner | [`product-team/agile-product-owner`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/agile-product-owner) | user_story_generator.py |
+| 2 | Product Manager Toolkit | [`product-team/product-manager-toolkit`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-manager-toolkit) | rice_prioritizer.py |
 
 ### Python Tools
 
 1. **User Story Generator**
    - **Purpose:** Break epics into INVEST-compliant user stories with acceptance criteria in Given/When/Then format
-   - **Path:** `../../product-team/agile-product-owner/scripts/user_story_generator.py`
+   - **Path:** [`scripts/user_story_generator.py`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/agile-product-owner/scripts/user_story_generator.py)
    - **Usage:** `python ../../product-team/agile-product-owner/scripts/user_story_generator.py epic.yaml`
    - **Features:** Epic decomposition, acceptance criteria generation, story point estimation, dependency mapping
    - **Use Cases:** Sprint planning, backlog refinement, story writing workshops
 
 2. **RICE Prioritizer**
    - **Purpose:** RICE framework for backlog prioritization with portfolio analysis
-   - **Path:** `../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py`
+   - **Path:** [`scripts/rice_prioritizer.py`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-manager-toolkit/scripts/rice_prioritizer.py)
    - **Usage:** `python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py backlog.csv --capacity 20`
    - **Features:** Portfolio quadrant analysis, capacity planning, quarterly roadmap generation
    - **Use Cases:** Backlog ordering, sprint scope decisions, stakeholder alignment
@@ -50,32 +50,32 @@ The cs-agile-product-owner agent bridges strategic product goals with sprint-lev
 ### Knowledge Bases
 
 1. **Sprint Planning Guide**
-   - **Location:** `../../product-team/agile-product-owner/references/sprint-planning-guide.md`
+   - **Location:** [`references/sprint-planning-guide.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/agile-product-owner/references/sprint-planning-guide.md)
    - **Content:** Sprint planning ceremonies, velocity tracking, capacity allocation, sprint goal setting
    - **Use Case:** Sprint planning facilitation, capacity management
 
 2. **User Story Templates**
-   - **Location:** `../../product-team/agile-product-owner/references/user-story-templates.md`
+   - **Location:** [`references/user-story-templates.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/agile-product-owner/references/user-story-templates.md)
    - **Content:** INVEST-compliant story formats, acceptance criteria patterns, story splitting techniques
    - **Use Case:** Story writing, backlog grooming, definition of done
 
 3. **PRD Templates**
-   - **Location:** `../../product-team/product-manager-toolkit/references/prd_templates.md`
+   - **Location:** [`references/prd_templates.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-manager-toolkit/references/prd_templates.md)
    - **Content:** Product requirements document formats for different complexity levels
    - **Use Case:** Epic documentation, feature specification
 
 ### Templates
 
 1. **Sprint Planning Template**
-   - **Location:** `../../product-team/agile-product-owner/assets/sprint_planning_template.md`
+   - **Location:** [`assets/sprint_planning_template.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/agile-product-owner/assets/sprint_planning_template.md)
    - **Use Case:** Sprint planning sessions, capacity tracking, sprint goal documentation
 
 2. **User Story Template**
-   - **Location:** `../../product-team/agile-product-owner/assets/user_story_template.md`
+   - **Location:** [`assets/user_story_template.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/agile-product-owner/assets/user_story_template.md)
    - **Use Case:** Consistent story format, acceptance criteria structure
 
 3. **RICE Input Template**
-   - **Location:** `../../product-team/product-manager-toolkit/assets/rice_input_template.csv`
+   - **Location:** [`assets/rice_input_template.csv`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-manager-toolkit/assets/rice_input_template.csv)
    - **Use Case:** Structuring backlog items for RICE prioritization
 
 ## Workflows
@@ -402,7 +402,7 @@ echo "Location: ../../product-team/agile-product-owner/references/user-story-tem
 - [cs-product-manager](cs-product-manager.md) - Full product management lifecycle (RICE, interviews, PRDs)
 - [cs-product-strategist](cs-product-strategist.md) - OKR cascade and strategic planning for roadmap alignment
 - [cs-ux-researcher](cs-ux-researcher.md) - User research to inform story requirements and acceptance criteria
-- Scrum Master - Velocity context and sprint execution (see `../../project-management/scrum-master/`)
+- Scrum Master - Velocity context and sprint execution (see [`project-management/scrum-master`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/scrum-master))
 
 ## References
 
diff --git a/docs/agents/cs-ceo-advisor.md b/docs/agents/cs-ceo-advisor.md
index 8e0c918..e01328b 100644
--- a/docs/agents/cs-ceo-advisor.md
+++ b/docs/agents/cs-ceo-advisor.md
@@ -22,20 +22,20 @@ The cs-ceo-advisor agent bridges the gap between strategic intent and operationa
 
 ## Skill Integration
 
-**Skill Location:** `../../c-level-advisor/ceo-advisor/`
+**Skill Location:** [`c-level-advisor/ceo-advisor`](https://github.com/alirezarezvani/claude-skills/tree/main/c-level-advisor/ceo-advisor)
 
 ### Python Tools
 
 1. **Strategy Analyzer**
    - **Purpose:** Analyzes strategic position using multiple frameworks (SWOT, Porter's Five Forces) and generates actionable recommendations
-   - **Path:** `../../c-level-advisor/ceo-advisor/scripts/strategy_analyzer.py`
+   - **Path:** [`scripts/strategy_analyzer.py`](https://github.com/alirezarezvani/claude-skills/tree/main/c-level-advisor/ceo-advisor/scripts/strategy_analyzer.py)
    - **Usage:** `python ../../c-level-advisor/ceo-advisor/scripts/strategy_analyzer.py`
    - **Features:** Market analysis, competitive positioning, strategic options generation, risk assessment
    - **Use Cases:** Annual strategic planning, market entry decisions, competitive analysis, strategic pivots
 
 2. **Financial Scenario Analyzer**
    - **Purpose:** Models different business scenarios with risk-adjusted financial projections and capital allocation recommendations
-   - **Path:** `../../c-level-advisor/ceo-advisor/scripts/financial_scenario_analyzer.py`
+   - **Path:** [`scripts/financial_scenario_analyzer.py`](https://github.com/alirezarezvani/claude-skills/tree/main/c-level-advisor/ceo-advisor/scripts/financial_scenario_analyzer.py)
    - **Usage:** `python ../../c-level-advisor/ceo-advisor/scripts/financial_scenario_analyzer.py`
    - **Features:** Scenario modeling, capital allocation optimization, runway analysis, valuation projections
    - **Use Cases:** Fundraising planning, budget allocation, M&A evaluation, strategic investment decisions
@@ -43,17 +43,17 @@ The cs-ceo-advisor agent bridges the gap between strategic intent and operationa
 ### Knowledge Bases
 
 1. **Executive Decision Framework**
-   - **Location:** `../../c-level-advisor/ceo-advisor/references/executive_decision_framework.md`
+   - **Location:** [`references/executive_decision_framework.md`](https://github.com/alirezarezvani/claude-skills/tree/main/c-level-advisor/ceo-advisor/references/executive_decision_framework.md)
    - **Content:** Structured decision-making process for go/no-go decisions, major pivots, M&A opportunities, crisis response
    - **Use Case:** High-stakes decision making, option evaluation, stakeholder alignment
 
 2. **Board Governance & Investor Relations**
-   - **Location:** `../../c-level-advisor/ceo-advisor/references/board_governance_investor_relations.md`
+   - **Location:** [`references/board_governance_investor_relations.md`](https://github.com/alirezarezvani/claude-skills/tree/main/c-level-advisor/ceo-advisor/references/board_governance_investor_relations.md)
    - **Content:** Board meeting preparation, board package templates, investor communication cadence, fundraising playbooks
    - **Use Case:** Board management, quarterly reporting, fundraising execution, investor updates
 
 3. **Leadership & Organizational Culture**
-   - **Location:** `../../c-level-advisor/ceo-advisor/references/leadership_organizational_culture.md`
+   - **Location:** [`references/leadership_organizational_culture.md`](https://github.com/alirezarezvani/claude-skills/tree/main/c-level-advisor/ceo-advisor/references/leadership_organizational_culture.md)
    - **Content:** Culture transformation frameworks, leadership development, change management, organizational design
    - **Use Case:** Culture building, organizational change, leadership team development, transformation management
 
diff --git a/docs/agents/cs-content-creator.md b/docs/agents/cs-content-creator.md
index 3f5fd6e..c9d2f3b 100644
--- a/docs/agents/cs-content-creator.md
+++ b/docs/agents/cs-content-creator.md
@@ -22,7 +22,7 @@ The cs-content-creator agent bridges the gap between creative content production
 
 ## Skill Integration
 
-**Skill Location:** `../../marketing-skill/content-creator/`
+**Skill Location:** [`marketing-skill/content-creator`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/content-creator)
 
 ### Python Tools
 
@@ -31,29 +31,29 @@ No Python tools — this skill relies on SKILL.md workflows, knowledge bases, an
 ### Knowledge Bases
 
 1. **Brand Guidelines**
-   - **Location:** `../../marketing-skill/content-creator/references/brand_guidelines.md`
+   - **Location:** [`references/brand_guidelines.md`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/content-creator/references/brand_guidelines.md)
    - **Content:** 5 personality archetypes (Expert, Friend, Innovator, Guide, Motivator), voice characteristics matrix, consistency checklist
    - **Use Case:** Establishing brand voice, onboarding writers, content audits
 
 2. **Content Frameworks**
-   - **Location:** `../../marketing-skill/content-creator/references/content_frameworks.md`
+   - **Location:** [`references/content_frameworks.md`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/content-creator/references/content_frameworks.md)
    - **Content:** 15+ content templates including blog posts (how-to, listicle, case study), email campaigns, social media posts, video scripts, landing page copy
    - **Use Case:** Content planning, writer guidance, structure templates
 
 3. **Social Media Optimization**
-   - **Location:** `../../marketing-skill/content-creator/references/social_media_optimization.md`
+   - **Location:** [`references/social_media_optimization.md`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/content-creator/references/social_media_optimization.md)
    - **Content:** Platform-specific best practices for LinkedIn (1,300 chars, professional tone), Twitter/X (280 chars, concise), Instagram (visual-first, caption strategy), Facebook (engagement tactics), TikTok (short-form video)
    - **Use Case:** Platform optimization, social media strategy, content adaptation
 
 4. **Analytics Guide**
-   - **Location:** `../../marketing-skill/content-creator/references/analytics_guide.md`
+   - **Location:** [`references/analytics_guide.md`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/content-creator/references/analytics_guide.md)
    - **Content:** Content performance analytics and measurement frameworks
    - **Use Case:** Content performance tracking, reporting, data-driven optimization
 
 ### Templates
 
 1. **Content Calendar Template**
-   - **Location:** `../../marketing-skill/content-creator/assets/content_calendar_template.md`
+   - **Location:** [`assets/content_calendar_template.md`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/content-creator/assets/content_calendar_template.md)
    - **Use Case:** Planning monthly content, tracking production pipeline
 
 ## Workflows
diff --git a/docs/agents/cs-cto-advisor.md b/docs/agents/cs-cto-advisor.md
index a400b9d..34d38cb 100644
--- a/docs/agents/cs-cto-advisor.md
+++ b/docs/agents/cs-cto-advisor.md
@@ -22,20 +22,20 @@ The cs-cto-advisor agent bridges the gap between technical vision and operationa
 
 ## Skill Integration
 
-**Skill Location:** `../../c-level-advisor/cto-advisor/`
+**Skill Location:** [`c-level-advisor/cto-advisor`](https://github.com/alirezarezvani/claude-skills/tree/main/c-level-advisor/cto-advisor)
 
 ### Python Tools
 
 1. **Tech Debt Analyzer**
    - **Purpose:** Analyzes system architecture, identifies technical debt, and provides prioritized reduction plan
-   - **Path:** `../../c-level-advisor/cto-advisor/scripts/tech_debt_analyzer.py`
+   - **Path:** [`scripts/tech_debt_analyzer.py`](https://github.com/alirezarezvani/claude-skills/tree/main/c-level-advisor/cto-advisor/scripts/tech_debt_analyzer.py)
    - **Usage:** `python ../../c-level-advisor/cto-advisor/scripts/tech_debt_analyzer.py`
    - **Features:** Debt categorization (critical/high/medium/low), capacity allocation recommendations, remediation roadmap
    - **Use Cases:** Quarterly planning, architecture reviews, resource allocation, legacy system assessment
 
 2. **Team Scaling Calculator**
    - **Purpose:** Calculates optimal hiring plan and team structure based on growth projections and engineering ratios
-   - **Path:** `../../c-level-advisor/cto-advisor/scripts/team_scaling_calculator.py`
+   - **Path:** [`scripts/team_scaling_calculator.py`](https://github.com/alirezarezvani/claude-skills/tree/main/c-level-advisor/cto-advisor/scripts/team_scaling_calculator.py)
    - **Usage:** `python ../../c-level-advisor/cto-advisor/scripts/team_scaling_calculator.py`
    - **Features:** Team size modeling, ratio optimization (manager:engineer, senior:mid:junior), capacity planning
    - **Use Cases:** Annual planning, rapid growth scaling, team reorg, hiring roadmap development
@@ -43,17 +43,17 @@ The cs-cto-advisor agent bridges the gap between technical vision and operationa
 ### Knowledge Bases
 
 1. **Architecture Decision Records (ADR)**
-   - **Location:** `../../c-level-advisor/cto-advisor/references/architecture_decision_records.md`
+   - **Location:** [`references/architecture_decision_records.md`](https://github.com/alirezarezvani/claude-skills/tree/main/c-level-advisor/cto-advisor/references/architecture_decision_records.md)
    - **Content:** ADR templates, examples, decision-making frameworks, architectural patterns
    - **Use Case:** Technology selection, architecture changes, documenting technical decisions, stakeholder alignment
 
 2. **Engineering Metrics**
-   - **Location:** `../../c-level-advisor/cto-advisor/references/engineering_metrics.md`
+   - **Location:** [`references/engineering_metrics.md`](https://github.com/alirezarezvani/claude-skills/tree/main/c-level-advisor/cto-advisor/references/engineering_metrics.md)
    - **Content:** DORA metrics implementation, quality metrics (test coverage, code review), team health indicators
    - **Use Case:** Performance measurement, continuous improvement, board reporting, benchmarking
 
 3. **Technology Evaluation Framework**
-   - **Location:** `../../c-level-advisor/cto-advisor/references/technology_evaluation_framework.md`
+   - **Location:** [`references/technology_evaluation_framework.md`](https://github.com/alirezarezvani/claude-skills/tree/main/c-level-advisor/cto-advisor/references/technology_evaluation_framework.md)
    - **Content:** Vendor selection criteria, build vs buy analysis, technology assessment templates
    - **Use Case:** Technology stack decisions, vendor evaluation, platform selection, procurement
 
diff --git a/docs/agents/cs-demand-gen-specialist.md b/docs/agents/cs-demand-gen-specialist.md
index b93f046..ab64f1e 100644
--- a/docs/agents/cs-demand-gen-specialist.md
+++ b/docs/agents/cs-demand-gen-specialist.md
@@ -22,13 +22,13 @@ The cs-demand-gen-specialist agent bridges the gap between marketing strategy an
 
 ## Skill Integration
 
-**Skill Location:** `../../marketing-skill/marketing-demand-acquisition/`
+**Skill Location:** [`marketing-skill/marketing-demand-acquisition`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/marketing-demand-acquisition)
 
 ### Python Tools
 
 1. **CAC Calculator**
    - **Purpose:** Calculates Customer Acquisition Cost (CAC) across channels and campaigns
-   - **Path:** `../../marketing-skill/marketing-demand-acquisition/scripts/calculate_cac.py`
+   - **Path:** [`scripts/calculate_cac.py`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/marketing-demand-acquisition/scripts/calculate_cac.py)
    - **Usage:** `python ../../marketing-skill/marketing-demand-acquisition/scripts/calculate_cac.py campaign-spend.csv customer-data.csv`
    - **Features:** CAC calculation by channel, LTV:CAC ratio, payback period analysis, ROI metrics
    - **Use Cases:** Budget allocation, channel performance evaluation, campaign ROI analysis
@@ -38,22 +38,22 @@ The cs-demand-gen-specialist agent bridges the gap between marketing strategy an
 ### Knowledge Bases
 
 1. **Attribution Guide**
-   - **Location:** `../../marketing-skill/marketing-demand-acquisition/references/attribution-guide.md`
+   - **Location:** [`references/attribution-guide.md`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/marketing-demand-acquisition/references/attribution-guide.md)
    - **Content:** Marketing attribution models, channel attribution, ROI measurement frameworks
    - **Use Case:** Campaign attribution, channel performance analysis, budget justification
 
 2. **Campaign Templates**
-   - **Location:** `../../marketing-skill/marketing-demand-acquisition/references/campaign-templates.md`
+   - **Location:** [`references/campaign-templates.md`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/marketing-demand-acquisition/references/campaign-templates.md)
    - **Content:** Reusable campaign structures, launch checklists, multi-channel campaign blueprints
    - **Use Case:** Campaign planning, rapid campaign setup, standardized launch processes
 
 3. **HubSpot Workflows**
-   - **Location:** `../../marketing-skill/marketing-demand-acquisition/references/hubspot-workflows.md`
+   - **Location:** [`references/hubspot-workflows.md`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/marketing-demand-acquisition/references/hubspot-workflows.md)
    - **Content:** HubSpot automation workflows, lead nurturing sequences, CRM integration patterns
    - **Use Case:** Marketing automation, lead scoring, nurture campaign setup
 
 4. **International Playbooks**
-   - **Location:** `../../marketing-skill/marketing-demand-acquisition/references/international-playbooks.md`
+   - **Location:** [`references/international-playbooks.md`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/marketing-demand-acquisition/references/international-playbooks.md)
    - **Content:** International market expansion strategies, localization best practices, regional channel optimization
    - **Use Case:** Global campaign planning, market entry strategy, cross-border demand generation
 
diff --git a/docs/agents/cs-product-analyst.md b/docs/agents/cs-product-analyst.md
index 7a1a958..b552ecc 100644
--- a/docs/agents/cs-product-analyst.md
+++ b/docs/agents/cs-product-analyst.md
@@ -13,8 +13,8 @@ description: "Product Analyst Agent - Claude Code agent for Product."
 
 
 ## Skill Links
-- `../../product-team/product-analytics/SKILL.md`
-- `../../product-team/experiment-designer/SKILL.md`
+- [`product-analytics/SKILL.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-analytics/SKILL.md)
+- [`experiment-designer/SKILL.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/experiment-designer/SKILL.md)
 
 ## Primary Workflows
 1. Metric framework and KPI definition
@@ -23,8 +23,8 @@ description: "Product Analyst Agent - Claude Code agent for Product."
 4. Result interpretation and decision recommendations
 
 ## Tooling
-- `../../product-team/product-analytics/scripts/metrics_calculator.py`
-- `../../product-team/experiment-designer/scripts/sample_size_calculator.py`
+- [`scripts/metrics_calculator.py`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-analytics/scripts/metrics_calculator.py)
+- [`scripts/sample_size_calculator.py`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/experiment-designer/scripts/sample_size_calculator.py)
 
 ## Usage Notes
 - Define decision metrics before analysis to avoid post-hoc bias.
diff --git a/docs/agents/cs-product-manager.md b/docs/agents/cs-product-manager.md
index 56e8069..d1b7cbc 100644
--- a/docs/agents/cs-product-manager.md
+++ b/docs/agents/cs-product-manager.md
@@ -22,26 +22,26 @@ The cs-product-manager agent bridges the gap between customer insights and produ
 
 ## Skill Integration
 
-**Primary Skill:** `../../product-team/product-manager-toolkit/`
+**Primary Skill:** [`product-team/product-manager-toolkit`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-manager-toolkit)
 
 ### All Orchestrated Skills
 
 | # | Skill | Location | Primary Tool |
 |---|-------|----------|-------------|
-| 1 | Product Manager Toolkit | `../../product-team/product-manager-toolkit/` | rice_prioritizer.py, customer_interview_analyzer.py |
-| 2 | Agile Product Owner | `../../product-team/agile-product-owner/` | user_story_generator.py |
-| 3 | Product Strategist | `../../product-team/product-strategist/` | okr_cascade_generator.py |
-| 4 | UX Researcher & Designer | `../../product-team/ux-researcher-designer/` | persona_generator.py |
-| 5 | UI Design System | `../../product-team/ui-design-system/` | design_token_generator.py |
-| 6 | Competitive Teardown | `../../product-team/competitive-teardown/` | competitive_matrix_builder.py |
-| 7 | Landing Page Generator | `../../product-team/landing-page-generator/` | landing_page_scaffolder.py |
-| 8 | SaaS Scaffolder | `../../product-team/saas-scaffolder/` | project_bootstrapper.py |
+| 1 | Product Manager Toolkit | [`product-team/product-manager-toolkit`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-manager-toolkit) | rice_prioritizer.py, customer_interview_analyzer.py |
+| 2 | Agile Product Owner | [`product-team/agile-product-owner`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/agile-product-owner) | user_story_generator.py |
+| 3 | Product Strategist | [`product-team/product-strategist`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-strategist) | okr_cascade_generator.py |
+| 4 | UX Researcher & Designer | [`product-team/ux-researcher-designer`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ux-researcher-designer) | persona_generator.py |
+| 5 | UI Design System | [`product-team/ui-design-system`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ui-design-system) | design_token_generator.py |
+| 6 | Competitive Teardown | [`product-team/competitive-teardown`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/competitive-teardown) | competitive_matrix_builder.py |
+| 7 | Landing Page Generator | [`product-team/landing-page-generator`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/landing-page-generator) | landing_page_scaffolder.py |
+| 8 | SaaS Scaffolder | [`product-team/saas-scaffolder`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/saas-scaffolder) | project_bootstrapper.py |
 
 ### Python Tools
 
 1. **RICE Prioritizer**
    - **Purpose:** RICE framework implementation for feature prioritization with portfolio analysis and capacity planning
-   - **Path:** `../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py`
+   - **Path:** [`scripts/rice_prioritizer.py`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-manager-toolkit/scripts/rice_prioritizer.py)
    - **Usage:** `python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py features.csv --capacity 20`
    - **Formula:** RICE Score = (Reach × Impact × Confidence) / Effort
    - **Features:** Portfolio analysis (quick wins vs big bets), quarterly roadmap generation, capacity planning, JSON/CSV export
@@ -49,117 +49,117 @@ The cs-product-manager agent bridges the gap between customer insights and produ
 
 2. **Customer Interview Analyzer**
    - **Purpose:** NLP-based interview transcript analysis to extract pain points, feature requests, and themes
-   - **Path:** `../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py`
+   - **Path:** [`scripts/customer_interview_analyzer.py`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py)
    - **Usage:** `python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py interview.txt`
    - **Features:** Pain point extraction with severity, feature request identification, jobs-to-be-done patterns, sentiment analysis, theme extraction
    - **Use Cases:** User research synthesis, discovery validation, problem prioritization, insight generation
 
 3. **User Story Generator**
    - **Purpose:** Break epics into INVEST-compliant user stories with acceptance criteria
-   - **Path:** `../../product-team/agile-product-owner/scripts/user_story_generator.py`
+   - **Path:** [`scripts/user_story_generator.py`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/agile-product-owner/scripts/user_story_generator.py)
    - **Usage:** `python ../../product-team/agile-product-owner/scripts/user_story_generator.py epic.yaml`
    - **Use Cases:** Sprint planning, backlog refinement, story decomposition
 
 4. **OKR Cascade Generator**
    - **Purpose:** Generate cascaded OKRs from company objectives to team-level key results
-   - **Path:** `../../product-team/product-strategist/scripts/okr_cascade_generator.py`
+   - **Path:** [`scripts/okr_cascade_generator.py`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-strategist/scripts/okr_cascade_generator.py)
    - **Usage:** `python ../../product-team/product-strategist/scripts/okr_cascade_generator.py growth`
    - **Use Cases:** Quarterly planning, strategic alignment, goal setting
 
 5. **Persona Generator**
    - **Purpose:** Create data-driven user personas from research inputs
-   - **Path:** `../../product-team/ux-researcher-designer/scripts/persona_generator.py`
+   - **Path:** [`scripts/persona_generator.py`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ux-researcher-designer/scripts/persona_generator.py)
    - **Usage:** `python ../../product-team/ux-researcher-designer/scripts/persona_generator.py research-data.json`
    - **Use Cases:** User research synthesis, persona development, journey mapping
 
 6. **Design Token Generator**
    - **Purpose:** Generate design tokens for consistent UI implementation
-   - **Path:** `../../product-team/ui-design-system/scripts/design_token_generator.py`
+   - **Path:** [`scripts/design_token_generator.py`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ui-design-system/scripts/design_token_generator.py)
    - **Usage:** `python ../../product-team/ui-design-system/scripts/design_token_generator.py theme.json`
    - **Use Cases:** Design system creation, developer handoff, theming
 
 7. **Competitive Matrix Builder**
    - **Purpose:** Build competitive analysis matrices and feature comparison grids
-   - **Path:** `../../product-team/competitive-teardown/scripts/competitive_matrix_builder.py`
+   - **Path:** [`scripts/competitive_matrix_builder.py`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/competitive-teardown/scripts/competitive_matrix_builder.py)
    - **Usage:** `python ../../product-team/competitive-teardown/scripts/competitive_matrix_builder.py competitors.csv`
    - **Use Cases:** Competitive intelligence, market positioning, feature gap analysis
 
 8. **Landing Page Scaffolder**
    - **Purpose:** Generate conversion-optimized landing page scaffolds
-   - **Path:** `../../product-team/landing-page-generator/scripts/landing_page_scaffolder.py`
+   - **Path:** [`scripts/landing_page_scaffolder.py`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/landing-page-generator/scripts/landing_page_scaffolder.py)
    - **Usage:** `python ../../product-team/landing-page-generator/scripts/landing_page_scaffolder.py config.yaml`
    - **Use Cases:** Product launches, A/B testing, GTM campaigns
 
 9. **Project Bootstrapper**
    - **Purpose:** Scaffold SaaS project structures with boilerplate and configurations
-   - **Path:** `../../product-team/saas-scaffolder/scripts/project_bootstrapper.py`
+   - **Path:** [`scripts/project_bootstrapper.py`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/saas-scaffolder/scripts/project_bootstrapper.py)
    - **Usage:** `python ../../product-team/saas-scaffolder/scripts/project_bootstrapper.py --stack nextjs --name my-saas`
    - **Use Cases:** MVP scaffolding, project kickoff, SaaS prototype creation
 
 ### Knowledge Bases
 
 1. **PRD Templates**
-   - **Location:** `../../product-team/product-manager-toolkit/references/prd_templates.md`
+   - **Location:** [`references/prd_templates.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-manager-toolkit/references/prd_templates.md)
    - **Content:** Multiple PRD formats (Standard PRD, One-Page PRD, Feature Brief, Agile Epic), structure guidelines, best practices
    - **Use Case:** Requirements documentation, stakeholder communication, engineering handoff
 
 2. **Sprint Planning Guide**
-   - **Location:** `../../product-team/agile-product-owner/references/sprint-planning-guide.md`
+   - **Location:** [`references/sprint-planning-guide.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/agile-product-owner/references/sprint-planning-guide.md)
    - **Content:** Sprint planning ceremonies, velocity tracking, capacity allocation
    - **Use Case:** Sprint execution, backlog refinement, agile ceremonies
 
 3. **User Story Templates**
-   - **Location:** `../../product-team/agile-product-owner/references/user-story-templates.md`
+   - **Location:** [`references/user-story-templates.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/agile-product-owner/references/user-story-templates.md)
    - **Content:** INVEST-compliant story formats, acceptance criteria patterns, story splitting techniques
    - **Use Case:** Story writing, backlog grooming, definition of done
 
 4. **OKR Framework**
-   - **Location:** `../../product-team/product-strategist/references/okr_framework.md`
+   - **Location:** [`references/okr_framework.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-strategist/references/okr_framework.md)
    - **Content:** OKR methodology, cascade patterns, scoring guidelines
    - **Use Case:** Quarterly planning, strategic alignment, goal tracking
 
 5. **Strategy Types**
-   - **Location:** `../../product-team/product-strategist/references/strategy_types.md`
+   - **Location:** [`references/strategy_types.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-strategist/references/strategy_types.md)
    - **Content:** Product strategy frameworks, competitive positioning, growth strategies
    - **Use Case:** Strategic planning, market analysis, product vision
 
 6. **Persona Methodology**
-   - **Location:** `../../product-team/ux-researcher-designer/references/persona-methodology.md`
+   - **Location:** [`references/persona-methodology.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ux-researcher-designer/references/persona-methodology.md)
    - **Content:** Research-backed persona creation methodology, data collection, validation
    - **Use Case:** Persona development, user segmentation, research planning
 
 7. **Example Personas**
-   - **Location:** `../../product-team/ux-researcher-designer/references/example-personas.md`
+   - **Location:** [`references/example-personas.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ux-researcher-designer/references/example-personas.md)
    - **Content:** Sample persona documents with demographics, goals, pain points, behaviors
    - **Use Case:** Persona templates, research documentation
 
 8. **Journey Mapping Guide**
-   - **Location:** `../../product-team/ux-researcher-designer/references/journey-mapping-guide.md`
+   - **Location:** [`references/journey-mapping-guide.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ux-researcher-designer/references/journey-mapping-guide.md)
    - **Content:** Customer journey mapping methodology, touchpoint analysis, emotion mapping
    - **Use Case:** Experience design, touchpoint optimization, service design
 
 9. **Usability Testing Frameworks**
-   - **Location:** `../../product-team/ux-researcher-designer/references/usability-testing-frameworks.md`
+   - **Location:** [`references/usability-testing-frameworks.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ux-researcher-designer/references/usability-testing-frameworks.md)
    - **Content:** Usability test planning, task design, analysis methods
    - **Use Case:** Usability studies, prototype validation, UX evaluation
 
 10. **Component Architecture**
-    - **Location:** `../../product-team/ui-design-system/references/component-architecture.md`
+    - **Location:** [`references/component-architecture.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ui-design-system/references/component-architecture.md)
     - **Content:** Component hierarchy, atomic design patterns, composition strategies
     - **Use Case:** Design system architecture, component libraries
 
 11. **Developer Handoff**
-    - **Location:** `../../product-team/ui-design-system/references/developer-handoff.md`
+    - **Location:** [`references/developer-handoff.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ui-design-system/references/developer-handoff.md)
     - **Content:** Design-to-dev handoff process, specification formats, asset delivery
     - **Use Case:** Engineering collaboration, implementation specs
 
 12. **Responsive Calculations**
-    - **Location:** `../../product-team/ui-design-system/references/responsive-calculations.md`
+    - **Location:** [`references/responsive-calculations.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ui-design-system/references/responsive-calculations.md)
     - **Content:** Responsive design formulas, breakpoint strategies, fluid typography
     - **Use Case:** Responsive implementation, cross-device design
 
 13. **Token Generation**
-    - **Location:** `../../product-team/ui-design-system/references/token-generation.md`
+    - **Location:** [`references/token-generation.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ui-design-system/references/token-generation.md)
     - **Content:** Design token standards, naming conventions, platform-specific output
     - **Use Case:** Design system tokens, theming, multi-platform consistency
 
diff --git a/docs/agents/cs-product-strategist.md b/docs/agents/cs-product-strategist.md
index 7f6de00..82df49d 100644
--- a/docs/agents/cs-product-strategist.md
+++ b/docs/agents/cs-product-strategist.md
@@ -22,35 +22,35 @@ The cs-product-strategist agent operates at the intersection of business strateg
 
 ## Skill Integration
 
-**Primary Skill:** `../../product-team/product-strategist/`
+**Primary Skill:** [`product-team/product-strategist`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-strategist)
 
 ### All Orchestrated Skills
 
 | # | Skill | Location | Primary Tool |
 |---|-------|----------|-------------|
-| 1 | Product Strategist | `../../product-team/product-strategist/` | okr_cascade_generator.py |
-| 2 | Competitive Teardown | `../../product-team/competitive-teardown/` | competitive_matrix_builder.py |
-| 3 | Product Manager Toolkit | `../../product-team/product-manager-toolkit/` | rice_prioritizer.py |
+| 1 | Product Strategist | [`product-team/product-strategist`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-strategist) | okr_cascade_generator.py |
+| 2 | Competitive Teardown | [`product-team/competitive-teardown`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/competitive-teardown) | competitive_matrix_builder.py |
+| 3 | Product Manager Toolkit | [`product-team/product-manager-toolkit`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-manager-toolkit) | rice_prioritizer.py |
 
 ### Python Tools
 
 1. **OKR Cascade Generator**
    - **Purpose:** Generate cascaded OKRs from company objectives to team-level key results with initiative mapping
-   - **Path:** `../../product-team/product-strategist/scripts/okr_cascade_generator.py`
+   - **Path:** [`scripts/okr_cascade_generator.py`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-strategist/scripts/okr_cascade_generator.py)
    - **Usage:** `python ../../product-team/product-strategist/scripts/okr_cascade_generator.py growth`
    - **Features:** Multi-level cascade (company > product > team), initiative mapping, scoring framework, tracking cadence
    - **Use Cases:** Quarterly planning, strategic alignment, goal setting, annual planning
 
 2. **Competitive Matrix Builder**
    - **Purpose:** Build competitive analysis matrices, feature comparison grids, and positioning maps
-   - **Path:** `../../product-team/competitive-teardown/scripts/competitive_matrix_builder.py`
+   - **Path:** [`scripts/competitive_matrix_builder.py`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/competitive-teardown/scripts/competitive_matrix_builder.py)
    - **Usage:** `python ../../product-team/competitive-teardown/scripts/competitive_matrix_builder.py competitors.csv`
    - **Features:** Multi-dimensional scoring, weighted comparison, gap analysis, positioning visualization
    - **Use Cases:** Competitive intelligence, market positioning, feature gap analysis, strategic differentiation
 
 3. **RICE Prioritizer**
    - **Purpose:** Strategic initiative prioritization using RICE framework for portfolio-level decisions
-   - **Path:** `../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py`
+   - **Path:** [`scripts/rice_prioritizer.py`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-manager-toolkit/scripts/rice_prioritizer.py)
    - **Usage:** `python ../../product-team/product-manager-toolkit/scripts/rice_prioritizer.py initiatives.csv --capacity 50`
    - **Features:** Portfolio quadrant analysis (big bets, quick wins), capacity planning, strategic roadmap generation
    - **Use Cases:** Initiative prioritization, resource allocation, strategic portfolio management
@@ -58,38 +58,38 @@ The cs-product-strategist agent operates at the intersection of business strateg
 ### Knowledge Bases
 
 1. **OKR Framework**
-   - **Location:** `../../product-team/product-strategist/references/okr_framework.md`
+   - **Location:** [`references/okr_framework.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-strategist/references/okr_framework.md)
    - **Content:** OKR methodology, cascade patterns, scoring guidelines, common pitfalls
    - **Use Case:** OKR education, quarterly planning preparation
 
 2. **Strategy Types**
-   - **Location:** `../../product-team/product-strategist/references/strategy_types.md`
+   - **Location:** [`references/strategy_types.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-strategist/references/strategy_types.md)
    - **Content:** Product strategy frameworks, competitive positioning models, growth strategies
    - **Use Case:** Strategy formulation, market analysis, product vision development
 
 3. **Data Collection Guide**
-   - **Location:** `../../product-team/competitive-teardown/references/data-collection-guide.md`
+   - **Location:** [`references/data-collection-guide.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/competitive-teardown/references/data-collection-guide.md)
    - **Content:** Sources and methods for gathering competitive intelligence ethically
    - **Use Case:** Competitive research planning, data source identification
 
 4. **Scoring Rubric**
-   - **Location:** `../../product-team/competitive-teardown/references/scoring-rubric.md`
+   - **Location:** [`references/scoring-rubric.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/competitive-teardown/references/scoring-rubric.md)
    - **Content:** Standardized scoring criteria for competitive dimensions (1-10 scale)
    - **Use Case:** Consistent competitor evaluation, bias mitigation
 
 5. **Analysis Templates**
-   - **Location:** `../../product-team/competitive-teardown/references/analysis-templates.md`
+   - **Location:** [`references/analysis-templates.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/competitive-teardown/references/analysis-templates.md)
    - **Content:** SWOT, Porter's Five Forces, positioning maps, battle cards, win/loss analysis
    - **Use Case:** Structured competitive analysis, sales enablement
 
 ### Templates
 
 1. **OKR Template**
-   - **Location:** `../../product-team/product-strategist/assets/okr_template.md`
+   - **Location:** [`assets/okr_template.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-strategist/assets/okr_template.md)
    - **Use Case:** Quarterly OKR documentation with tracking structure
 
 2. **PRD Template**
-   - **Location:** `../../product-team/product-manager-toolkit/assets/prd_template.md`
+   - **Location:** [`assets/prd_template.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-manager-toolkit/assets/prd_template.md)
    - **Use Case:** Documenting strategic initiatives as formal requirements
 
 ## Workflows
@@ -472,7 +472,7 @@ python ../../product-team/product-strategist/scripts/okr_cascade_generator.py gr
 - [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](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/`)
+- Senior PM Skill - Portfolio context (see [`project-management/senior-pm`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/senior-pm))
 
 ## References
 
diff --git a/docs/agents/cs-project-manager.md b/docs/agents/cs-project-manager.md
index 92d71b0..6f0e087 100644
--- a/docs/agents/cs-project-manager.md
+++ b/docs/agents/cs-project-manager.md
@@ -24,103 +24,103 @@ The cs-project-manager agent bridges the gap between project execution and strat
 
 ### Senior PM
 
-**Skill Location:** `../../project-management/senior-pm/`
+**Skill Location:** [`project-management/senior-pm`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/senior-pm)
 
 **Python Tools:**
 
 1. **Project Health Dashboard**
    - **Purpose:** Generate portfolio-level health dashboard with RAG status across all active projects
-   - **Path:** `../../project-management/senior-pm/scripts/project_health_dashboard.py`
+   - **Path:** [`scripts/project_health_dashboard.py`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/senior-pm/scripts/project_health_dashboard.py)
    - **Usage:** `python ../../project-management/senior-pm/scripts/project_health_dashboard.py sample_project_data.json`
    - **Features:** Schedule variance, budget tracking, risk exposure, milestone status, RAG indicators
 
 2. **Risk Matrix Analyzer**
    - **Purpose:** Quantitative risk analysis with probability-impact matrices and Expected Monetary Value (EMV)
-   - **Path:** `../../project-management/senior-pm/scripts/risk_matrix_analyzer.py`
+   - **Path:** [`scripts/risk_matrix_analyzer.py`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/senior-pm/scripts/risk_matrix_analyzer.py)
    - **Usage:** `python ../../project-management/senior-pm/scripts/risk_matrix_analyzer.py risks.json`
    - **Features:** Risk scoring, heat map generation, mitigation tracking, EMV calculation
 
 3. **Resource Capacity Planner**
    - **Purpose:** Team resource allocation and capacity forecasting across sprints and projects
-   - **Path:** `../../project-management/senior-pm/scripts/resource_capacity_planner.py`
+   - **Path:** [`scripts/resource_capacity_planner.py`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/senior-pm/scripts/resource_capacity_planner.py)
    - **Usage:** `python ../../project-management/senior-pm/scripts/resource_capacity_planner.py team_data.json`
    - **Features:** Utilization analysis, over-allocation detection, capacity forecasting, cross-project balancing
 
 **Knowledge Bases:**
 
-- `../../project-management/senior-pm/references/portfolio-prioritization-models.md` -- WSJF, MoSCoW, Cost of Delay, portfolio scoring frameworks
-- `../../project-management/senior-pm/references/risk-management-framework.md` -- Risk identification, qualitative/quantitative analysis, response strategies
-- `../../project-management/senior-pm/references/portfolio-kpis.md` -- KPI definitions, tracking cadences, executive reporting metrics
+- [`references/portfolio-prioritization-models.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/senior-pm/references/portfolio-prioritization-models.md) -- WSJF, MoSCoW, Cost of Delay, portfolio scoring frameworks
+- [`references/risk-management-framework.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/senior-pm/references/risk-management-framework.md) -- Risk identification, qualitative/quantitative analysis, response strategies
+- [`references/portfolio-kpis.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/senior-pm/references/portfolio-kpis.md) -- KPI definitions, tracking cadences, executive reporting metrics
 
 **Templates:**
 
-- `../../project-management/senior-pm/assets/executive_report_template.md` -- Executive status report with RAG, risks, decisions needed
-- `../../project-management/senior-pm/assets/project_charter_template.md` -- Project charter with scope, objectives, constraints, stakeholders
-- `../../project-management/senior-pm/assets/raci_matrix_template.md` -- Responsibility assignment matrix for cross-functional teams
+- [`assets/executive_report_template.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/senior-pm/assets/executive_report_template.md) -- Executive status report with RAG, risks, decisions needed
+- [`assets/project_charter_template.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/senior-pm/assets/project_charter_template.md) -- Project charter with scope, objectives, constraints, stakeholders
+- [`assets/raci_matrix_template.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/senior-pm/assets/raci_matrix_template.md) -- Responsibility assignment matrix for cross-functional teams
 
 ### Scrum Master
 
-**Skill Location:** `../../project-management/scrum-master/`
+**Skill Location:** [`project-management/scrum-master`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/scrum-master)
 
 **Python Tools:**
 
 1. **Sprint Health Scorer**
    - **Purpose:** Quantitative sprint health assessment across scope, velocity, quality, and team morale
-   - **Path:** `../../project-management/scrum-master/scripts/sprint_health_scorer.py`
+   - **Path:** [`scripts/sprint_health_scorer.py`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/scrum-master/scripts/sprint_health_scorer.py)
    - **Usage:** `python ../../project-management/scrum-master/scripts/sprint_health_scorer.py sample_sprint_data.json`
    - **Features:** Multi-dimensional scoring (0-100), trend analysis, health indicators, actionable recommendations
 
 2. **Velocity Analyzer**
    - **Purpose:** Historical velocity analysis with forecasting and confidence intervals
-   - **Path:** `../../project-management/scrum-master/scripts/velocity_analyzer.py`
+   - **Path:** [`scripts/velocity_analyzer.py`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/scrum-master/scripts/velocity_analyzer.py)
    - **Usage:** `python ../../project-management/scrum-master/scripts/velocity_analyzer.py sprint_history.json`
    - **Features:** Rolling averages, standard deviation, sprint-over-sprint trends, capacity prediction
 
 3. **Retrospective Analyzer**
    - **Purpose:** Structured retrospective analysis with action item tracking and theme extraction
-   - **Path:** `../../project-management/scrum-master/scripts/retrospective_analyzer.py`
+   - **Path:** [`scripts/retrospective_analyzer.py`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/scrum-master/scripts/retrospective_analyzer.py)
    - **Usage:** `python ../../project-management/scrum-master/scripts/retrospective_analyzer.py retro_notes.json`
    - **Features:** Theme clustering, sentiment analysis, action item extraction, trend tracking across sprints
 
 **Knowledge Bases:**
 
-- `../../project-management/scrum-master/references/retro-formats.md` -- Start/Stop/Continue, 4Ls, Sailboat, Mad/Sad/Glad, Starfish formats
-- `../../project-management/scrum-master/references/team-dynamics-framework.md` -- Tuckman stages, psychological safety, conflict resolution
-- `../../project-management/scrum-master/references/velocity-forecasting-guide.md` -- Monte Carlo simulation, confidence ranges, capacity planning
+- [`references/retro-formats.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/scrum-master/references/retro-formats.md) -- Start/Stop/Continue, 4Ls, Sailboat, Mad/Sad/Glad, Starfish formats
+- [`references/team-dynamics-framework.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/scrum-master/references/team-dynamics-framework.md) -- Tuckman stages, psychological safety, conflict resolution
+- [`references/velocity-forecasting-guide.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/scrum-master/references/velocity-forecasting-guide.md) -- Monte Carlo simulation, confidence ranges, capacity planning
 
 **Templates:**
 
-- `../../project-management/scrum-master/assets/sprint_report_template.md` -- Sprint review report with burndown, velocity, demo notes
-- `../../project-management/scrum-master/assets/team_health_check_template.md` -- Spotify-style team health check across 8 dimensions
+- [`assets/sprint_report_template.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/scrum-master/assets/sprint_report_template.md) -- Sprint review report with burndown, velocity, demo notes
+- [`assets/team_health_check_template.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/scrum-master/assets/team_health_check_template.md) -- Spotify-style team health check across 8 dimensions
 
 ### Jira Expert
 
-**Skill Location:** `../../project-management/jira-expert/`
+**Skill Location:** [`project-management/jira-expert`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/jira-expert)
 
 **Knowledge Bases:**
 
-- `../../project-management/jira-expert/references/jql-examples.md` -- JQL query patterns for backlog grooming, sprint reporting, SLA tracking
-- `../../project-management/jira-expert/references/automation-examples.md` -- Jira automation rule templates for common workflows
-- `../../project-management/jira-expert/references/AUTOMATION.md` -- Comprehensive automation guide with triggers, conditions, actions
-- `../../project-management/jira-expert/references/WORKFLOWS.md` -- Workflow design patterns, transition rules, validators, post-functions
+- [`references/jql-examples.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/jira-expert/references/jql-examples.md) -- JQL query patterns for backlog grooming, sprint reporting, SLA tracking
+- [`references/automation-examples.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/jira-expert/references/automation-examples.md) -- Jira automation rule templates for common workflows
+- [`references/AUTOMATION.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/jira-expert/references/AUTOMATION.md) -- Comprehensive automation guide with triggers, conditions, actions
+- [`references/WORKFLOWS.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/jira-expert/references/WORKFLOWS.md) -- Workflow design patterns, transition rules, validators, post-functions
 
 ### Confluence Expert
 
-**Skill Location:** `../../project-management/confluence-expert/`
+**Skill Location:** [`project-management/confluence-expert`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/confluence-expert)
 
 **Knowledge Bases:**
 
-- `../../project-management/confluence-expert/references/templates.md` -- Page templates for sprint plans, meeting notes, decision logs, architecture docs
+- [`references/templates.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/confluence-expert/references/templates.md) -- Page templates for sprint plans, meeting notes, decision logs, architecture docs
 
 ### Atlassian Admin
 
-**Skill Location:** `../../project-management/atlassian-admin/`
+**Skill Location:** [`project-management/atlassian-admin`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/atlassian-admin)
 
 Covers user provisioning, permission schemes, project configuration, and integration setup. No scripts or references yet -- relies on SKILL.md workflows.
 
 ### Atlassian Templates
 
-**Skill Location:** `../../project-management/atlassian-templates/`
+**Skill Location:** [`project-management/atlassian-templates`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/atlassian-templates)
 
 Covers blueprint creation, custom page layouts, and reusable Confluence/Jira components. No scripts or references yet -- relies on SKILL.md workflows.
 
@@ -141,7 +141,7 @@ Covers blueprint creation, custom page layouts, and reusable Confluence/Jira com
    - Set sprint capacity at 80% of average velocity (buffer for unknowns)
 
 2. **Query Backlog via JQL** - Use jira-expert JQL patterns to pull prioritized candidates:
-   - Reference: `../../project-management/jira-expert/references/jql-examples.md`
+   - Reference: [`references/jql-examples.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/jira-expert/references/jql-examples.md)
    - Filter by priority, story points estimated, team assignment
    - Identify blocked items, external dependencies, carry-overs from previous sprint
 
@@ -154,17 +154,17 @@ Covers blueprint creation, custom page layouts, and reusable Confluence/Jira com
    - Adjust sprint capacity based on actual availability
 
 4. **Select Sprint Backlog** - Commit items within capacity:
-   - Apply WSJF or priority-based selection (ref: `../../project-management/senior-pm/references/portfolio-prioritization-models.md`)
+   - Apply WSJF or priority-based selection (ref: [`references/portfolio-prioritization-models.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/senior-pm/references/portfolio-prioritization-models.md))
    - Ensure sprint goal alignment -- every item should contribute to 1-2 goals
    - Include 10-15% capacity for bug fixes and operational work
 
 5. **Document Sprint Plan** - Create Confluence sprint plan page:
-   - Use template from `../../project-management/confluence-expert/references/templates.md`
+   - Use template from [`references/templates.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/confluence-expert/references/templates.md)
    - Include sprint goal, committed stories, capacity breakdown, risks
    - Link to Jira sprint board for live tracking
 
 6. **Set Up Sprint Tracking** - Configure dashboards and automation:
-   - Create burndown/burnup dashboard (ref: `../../project-management/jira-expert/references/AUTOMATION.md`)
+   - Create burndown/burnup dashboard (ref: [`references/AUTOMATION.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/jira-expert/references/AUTOMATION.md))
    - Set up daily standup reminder automation
    - Configure sprint scope change alerts
 
@@ -220,13 +220,13 @@ cat capacity_report.txt
    - Forecast resource needs for next quarter
 
 5. **Prepare Executive Report** - Assemble findings into report:
-   - Use template: `../../project-management/senior-pm/assets/executive_report_template.md`
+   - Use template: [`assets/executive_report_template.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/senior-pm/assets/executive_report_template.md)
    - Include RAG summary, risk heatmap, resource utilization chart
    - Highlight decisions needed from leadership
    - Provide recommendations with supporting data
 
 6. **Publish to Confluence** - Create executive dashboard page:
-   - Reference KPI definitions from `../../project-management/senior-pm/references/portfolio-kpis.md`
+   - Reference KPI definitions from [`references/portfolio-kpis.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/senior-pm/references/portfolio-kpis.md)
    - Embed Jira macros for live data
    - Set up weekly refresh cadence
 
@@ -260,7 +260,7 @@ cat resource_report.txt
    - Compare against previous sprint scores for trend analysis
 
 2. **Select Retro Format** - Choose format based on team needs:
-   - Reference: `../../project-management/scrum-master/references/retro-formats.md`
+   - Reference: [`references/retro-formats.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/scrum-master/references/retro-formats.md)
    - **Start/Stop/Continue**: General-purpose, good for new teams
    - **4Ls (Liked/Learned/Lacked/Longed For)**: Focuses on learning and growth
    - **Sailboat**: Visual metaphor for anchors (blockers) and wind (accelerators)
@@ -271,7 +271,7 @@ cat resource_report.txt
    - Present sprint metrics as context (not judgment)
    - Time-box each section (5 min brainstorm, 10 min discuss, 5 min vote)
    - Use dot voting to prioritize discussion topics
-   - Reference team dynamics from `../../project-management/scrum-master/references/team-dynamics-framework.md`
+   - Reference team dynamics from [`references/team-dynamics-framework.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/scrum-master/references/team-dynamics-framework.md)
 
 4. **Analyze Retro Output** - Extract structured insights:
    ```bash
@@ -288,7 +288,7 @@ cat resource_report.txt
    - Add action items to next sprint backlog
 
 6. **Document in Confluence** - Publish retro summary:
-   - Use sprint report template: `../../project-management/scrum-master/assets/sprint_report_template.md`
+   - Use sprint report template: [`assets/sprint_report_template.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/scrum-master/assets/sprint_report_template.md)
    - Include sprint health score, retro themes, action items, metrics trends
    - Link to previous retro pages for longitudinal tracking
 
@@ -331,22 +331,22 @@ cat retro_analysis.txt
    - Define priority scheme and SLA targets
 
 3. **Design Workflows** - Build workflows matching team process:
-   - Reference: `../../project-management/jira-expert/references/WORKFLOWS.md`
+   - Reference: [`references/WORKFLOWS.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/jira-expert/references/WORKFLOWS.md)
    - Map states: Backlog > Ready > In Progress > Review > QA > Done
    - Add transitions with conditions (e.g., assignee required for In Progress)
    - Configure validators (e.g., story points required before Done)
    - Set up post-functions (e.g., auto-assign reviewer, notify channel)
 
 4. **Configure Automation** - Set up time-saving automation rules:
-   - Reference: `../../project-management/jira-expert/references/AUTOMATION.md`
-   - Examples from: `../../project-management/jira-expert/references/automation-examples.md`
+   - Reference: [`references/AUTOMATION.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/jira-expert/references/AUTOMATION.md)
+   - Examples from: [`references/automation-examples.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/jira-expert/references/automation-examples.md)
    - Auto-transition: Move to In Progress when branch created
    - Auto-assign: Rotate assignments based on workload
    - Notifications: Slack alerts for blocked items, SLA breaches
    - Cleanup: Auto-close stale items after 30 days
 
 5. **Set Up Confluence Space** - Create team knowledge base:
-   - Reference: `../../project-management/confluence-expert/references/templates.md`
+   - Reference: [`references/templates.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/confluence-expert/references/templates.md)
    - Create space with standard page hierarchy:
      - Home (team overview, quick links)
      - Sprint Plans (per-sprint documentation)
@@ -360,7 +360,7 @@ cat retro_analysis.txt
    - Burndown/burnup chart gadget
    - Velocity chart for historical tracking
    - SLA compliance tracker
-   - Use JQL patterns from `../../project-management/jira-expert/references/jql-examples.md`
+   - Use JQL patterns from [`references/jql-examples.md`](https://github.com/alirezarezvani/claude-skills/tree/main/project-management/jira-expert/references/jql-examples.md)
 
 7. **Onboard Team** - Walk team through the setup:
    - Document workflow rules and why they exist
diff --git a/docs/agents/cs-ux-researcher.md b/docs/agents/cs-ux-researcher.md
index 77e8509..68bd56a 100644
--- a/docs/agents/cs-ux-researcher.md
+++ b/docs/agents/cs-ux-researcher.md
@@ -22,78 +22,78 @@ The cs-ux-researcher agent ensures that user needs drive product development. It
 
 ## Skill Integration
 
-**Primary Skill:** `../../product-team/ux-researcher-designer/`
+**Primary Skill:** [`product-team/ux-researcher-designer`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ux-researcher-designer)
 
 ### All Orchestrated Skills
 
 | # | Skill | Location | Primary Tool |
 |---|-------|----------|-------------|
-| 1 | UX Researcher & Designer | `../../product-team/ux-researcher-designer/` | persona_generator.py |
-| 2 | Product Manager Toolkit | `../../product-team/product-manager-toolkit/` | customer_interview_analyzer.py |
-| 3 | UI Design System | `../../product-team/ui-design-system/` | design_token_generator.py |
+| 1 | UX Researcher & Designer | [`product-team/ux-researcher-designer`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ux-researcher-designer) | persona_generator.py |
+| 2 | Product Manager Toolkit | [`product-team/product-manager-toolkit`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-manager-toolkit) | customer_interview_analyzer.py |
+| 3 | UI Design System | [`product-team/ui-design-system`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ui-design-system) | design_token_generator.py |
 
 ### Python Tools
 
 1. **Persona Generator**
    - **Purpose:** Create data-driven user personas from research inputs including demographics, goals, pain points, and behavioral patterns
-   - **Path:** `../../product-team/ux-researcher-designer/scripts/persona_generator.py`
+   - **Path:** [`scripts/persona_generator.py`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ux-researcher-designer/scripts/persona_generator.py)
    - **Usage:** `python ../../product-team/ux-researcher-designer/scripts/persona_generator.py research-data.json`
    - **Features:** Multiple persona generation, behavioral segmentation, needs hierarchy mapping, empathy map creation
    - **Use Cases:** Persona development, user segmentation, design alignment, stakeholder communication
 
 2. **Customer Interview Analyzer**
    - **Purpose:** NLP-based analysis of interview transcripts to extract pain points, feature requests, themes, and sentiment
-   - **Path:** `../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py`
+   - **Path:** [`scripts/customer_interview_analyzer.py`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py)
    - **Usage:** `python ../../product-team/product-manager-toolkit/scripts/customer_interview_analyzer.py interview.txt`
    - **Features:** Pain point extraction with severity scoring, feature request identification, jobs-to-be-done patterns, theme clustering, key quote extraction
    - **Use Cases:** Interview synthesis, discovery validation, problem prioritization, insight aggregation
 
 3. **Design Token Generator**
    - **Purpose:** Generate design tokens for consistent UI implementation across platforms
-   - **Path:** `../../product-team/ui-design-system/scripts/design_token_generator.py`
+   - **Path:** [`scripts/design_token_generator.py`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ui-design-system/scripts/design_token_generator.py)
    - **Usage:** `python ../../product-team/ui-design-system/scripts/design_token_generator.py theme.json`
    - **Use Cases:** Research-informed design system updates, accessibility token adjustments
 
 ### Knowledge Bases
 
 1. **Persona Methodology**
-   - **Location:** `../../product-team/ux-researcher-designer/references/persona-methodology.md`
+   - **Location:** [`references/persona-methodology.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ux-researcher-designer/references/persona-methodology.md)
    - **Content:** Research-backed persona creation methodology, data collection strategies, validation approaches
    - **Use Case:** Methodological guidance for persona projects
 
 2. **Example Personas**
-   - **Location:** `../../product-team/ux-researcher-designer/references/example-personas.md`
+   - **Location:** [`references/example-personas.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ux-researcher-designer/references/example-personas.md)
    - **Content:** Sample persona documents with demographics, goals, pain points, behaviors, scenarios
    - **Use Case:** Persona format reference, team training
 
 3. **Journey Mapping Guide**
-   - **Location:** `../../product-team/ux-researcher-designer/references/journey-mapping-guide.md`
+   - **Location:** [`references/journey-mapping-guide.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ux-researcher-designer/references/journey-mapping-guide.md)
    - **Content:** Customer journey mapping methodology, touchpoint analysis, emotion mapping, opportunity identification
    - **Use Case:** Journey map creation, experience design, service design
 
 4. **Usability Testing Frameworks**
-   - **Location:** `../../product-team/ux-researcher-designer/references/usability-testing-frameworks.md`
+   - **Location:** [`references/usability-testing-frameworks.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ux-researcher-designer/references/usability-testing-frameworks.md)
    - **Content:** Test planning, task design, analysis methods, severity ratings, reporting formats
    - **Use Case:** Usability study design, prototype validation, UX evaluation
 
 5. **Component Architecture**
-   - **Location:** `../../product-team/ui-design-system/references/component-architecture.md`
+   - **Location:** [`references/component-architecture.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ui-design-system/references/component-architecture.md)
    - **Content:** Component hierarchy, atomic design patterns, composition strategies
    - **Use Case:** Research-to-design translation, component recommendations
 
 6. **Developer Handoff**
-   - **Location:** `../../product-team/ui-design-system/references/developer-handoff.md`
+   - **Location:** [`references/developer-handoff.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ui-design-system/references/developer-handoff.md)
    - **Content:** Design-to-dev handoff process, specification formats, asset delivery
    - **Use Case:** Translating research findings into implementation specs
 
 ### Templates
 
 1. **Research Plan Template**
-   - **Location:** `../../product-team/ux-researcher-designer/assets/research_plan_template.md`
+   - **Location:** [`assets/research_plan_template.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ux-researcher-designer/assets/research_plan_template.md)
    - **Use Case:** Structuring research studies with methodology, participants, and analysis plan
 
 2. **Design System Documentation Template**
-   - **Location:** `../../product-team/ui-design-system/assets/design_system_doc_template.md`
+   - **Location:** [`assets/design_system_doc_template.md`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ui-design-system/assets/design_system_doc_template.md)
    - **Use Case:** Documenting research-informed design system decisions
 
 ## Workflows
@@ -514,7 +514,7 @@ echo "See: ../../product-team/ui-design-system/references/developer-handoff.md"
 - [cs-product-manager](cs-product-manager.md) - Product management lifecycle, interview analysis, PRD development
 - [cs-agile-product-owner](cs-agile-product-owner.md) - Translating research findings into user stories
 - [cs-product-strategist](cs-product-strategist.md) - Strategic research to validate product vision and positioning
-- UI Design System - Design handoff and component recommendations (see `../../product-team/ui-design-system/`)
+- UI Design System - Design handoff and component recommendations (see [`product-team/ui-design-system`](https://github.com/alirezarezvani/claude-skills/tree/main/product-team/ui-design-system))
 
 ## References
 
diff --git a/docs/agents/cs-workspace-admin.md b/docs/agents/cs-workspace-admin.md
index b939258..5566739 100644
--- a/docs/agents/cs-workspace-admin.md
+++ b/docs/agents/cs-workspace-admin.md
@@ -19,49 +19,49 @@ Google Workspace administration specialist orchestrating the gws CLI for email a
 ## Skill Integration
 
 ### Skill Location
-`../../engineering-team/google-workspace-cli/`
+[`engineering-team/google-workspace-cli`](https://github.com/alirezarezvani/claude-skills/tree/main/engineering-team/google-workspace-cli)
 
 ### Python Tools
 
 1. **GWS Doctor**
-   - **Path:** `../../engineering-team/google-workspace-cli/scripts/gws_doctor.py`
+   - **Path:** [`scripts/gws_doctor.py`](https://github.com/alirezarezvani/claude-skills/tree/main/engineering-team/google-workspace-cli/scripts/gws_doctor.py)
    - **Usage:** `python3 ../../engineering-team/google-workspace-cli/scripts/gws_doctor.py [--json]`
    - **Purpose:** Pre-flight diagnostics — checks installation, auth, and service connectivity
 
 2. **Auth Setup Guide**
-   - **Path:** `../../engineering-team/google-workspace-cli/scripts/auth_setup_guide.py`
+   - **Path:** [`scripts/auth_setup_guide.py`](https://github.com/alirezarezvani/claude-skills/tree/main/engineering-team/google-workspace-cli/scripts/auth_setup_guide.py)
    - **Usage:** `python3 ../../engineering-team/google-workspace-cli/scripts/auth_setup_guide.py --guide oauth`
    - **Purpose:** Guided auth setup, scope listing, .env generation, validation
 
 3. **Recipe Runner**
-   - **Path:** `../../engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py`
+   - **Path:** [`scripts/gws_recipe_runner.py`](https://github.com/alirezarezvani/claude-skills/tree/main/engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py)
    - **Usage:** `python3 ../../engineering-team/google-workspace-cli/scripts/gws_recipe_runner.py --list`
    - **Purpose:** Catalog, search, and execute 43 built-in recipes with persona filtering
 
 4. **Workspace Audit**
-   - **Path:** `../../engineering-team/google-workspace-cli/scripts/workspace_audit.py`
+   - **Path:** [`scripts/workspace_audit.py`](https://github.com/alirezarezvani/claude-skills/tree/main/engineering-team/google-workspace-cli/scripts/workspace_audit.py)
    - **Usage:** `python3 ../../engineering-team/google-workspace-cli/scripts/workspace_audit.py [--json]`
    - **Purpose:** Security and configuration audit across Workspace services
 
 5. **Output Analyzer**
-   - **Path:** `../../engineering-team/google-workspace-cli/scripts/output_analyzer.py`
+   - **Path:** [`scripts/output_analyzer.py`](https://github.com/alirezarezvani/claude-skills/tree/main/engineering-team/google-workspace-cli/scripts/output_analyzer.py)
    - **Usage:** `gws ... --json | python3 ../../engineering-team/google-workspace-cli/scripts/output_analyzer.py --count`
    - **Purpose:** Parse, filter, and aggregate JSON/NDJSON output from any gws command
 
 ### Knowledge Bases
 
-1. **Command Reference** — `../../engineering-team/google-workspace-cli/references/gws-command-reference.md`
+1. **Command Reference** — [`references/gws-command-reference.md`](https://github.com/alirezarezvani/claude-skills/tree/main/engineering-team/google-workspace-cli/references/gws-command-reference.md)
    - 18 services, 22 helpers, global flags, environment variables
-2. **Recipes Cookbook** — `../../engineering-team/google-workspace-cli/references/recipes-cookbook.md`
+2. **Recipes Cookbook** — [`references/recipes-cookbook.md`](https://github.com/alirezarezvani/claude-skills/tree/main/engineering-team/google-workspace-cli/references/recipes-cookbook.md)
    - 43 recipes organized by category with persona mapping
-3. **Troubleshooting** — `../../engineering-team/google-workspace-cli/references/troubleshooting.md`
+3. **Troubleshooting** — [`references/troubleshooting.md`](https://github.com/alirezarezvani/claude-skills/tree/main/engineering-team/google-workspace-cli/references/troubleshooting.md)
    - Common errors, auth issues, platform-specific fixes
 
 ### Templates
 
-1. **Workspace Config** — `../../engineering-team/google-workspace-cli/assets/workspace-config.json`
+1. **Workspace Config** — [`assets/workspace-config.json`](https://github.com/alirezarezvani/claude-skills/tree/main/engineering-team/google-workspace-cli/assets/workspace-config.json)
    - Automation config template with auth, defaults, scheduled tasks
-2. **Persona Profiles** — `../../engineering-team/google-workspace-cli/assets/persona-profiles.md`
+2. **Persona Profiles** — [`assets/persona-profiles.md`](https://github.com/alirezarezvani/claude-skills/tree/main/engineering-team/google-workspace-cli/assets/persona-profiles.md)
    - 10 role-based workflow bundles
 
 ## Core Workflows
diff --git a/scripts/generate-docs.py b/scripts/generate-docs.py
index 3b93cab..3b08ae5 100644
--- a/scripts/generate-docs.py
+++ b/scripts/generate-docs.py
@@ -173,7 +173,24 @@ def rewrite_relative_links(content, source_rel_path):
             return f"[{text}]({sibling})"
         return f"[{text}]({GITHUB_BASE}/{resolved})"
 
-    return re.sub(r"\[([^\]]+)\]\((\.\.[^\)]+)\)", resolve_link, content)
+    content = re.sub(r"\[([^\]]+)\]\((\.\.[^\)]+)\)", resolve_link, content)
+
+    # Also rewrite backtick code references like `../../product-team/foo/SKILL.md`
+    # Convert to clickable GitHub links
+    def resolve_backtick(match):
+        rel_target = match.group(1)
+        if not rel_target.startswith("../"):
+            return match.group(0)
+        resolved = os.path.normpath(os.path.join(source_dir, rel_target))
+        # Make the path a clickable link to the GitHub source
+        # Show parent/filename for context (e.g., product-analytics/SKILL.md)
+        parts = resolved.split("/")
+        display = "/".join(parts[-2:]) if len(parts) >= 2 else resolved
+        return f"[`{display}`]({GITHUB_BASE}/{resolved})"
+
+    content = re.sub(r"`(\.\./[^`]+)`", resolve_backtick, content)
+
+    return content
 
 
 def generate_skill_page(skill, domain_key):