firefrost-gaming/claude-skills-reference
3
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

fix(docs): convert backtick relative paths to clickable GitHub links

Browse Source 
Extend rewrite_relative_links() to also handle `../../path/to/file`
backtick code references, converting them to clickable links showing
parent/filename for context (e.g., product-analytics/SKILL.md).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Reza Rezvani
2026-03-11 15:27:32 +01:00
parent d10d324d50
commit aeab2174d2
12 changed files with 173 additions and 156 deletions
Download Patch File Download Diff File Expand all files Collapse all files

24
docs/agents/cs-agile-product-owner.md
View File

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

12
docs/agents/cs-ceo-advisor.md
View File

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

12
docs/agents/cs-content-creator.md
View File

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

12
docs/agents/cs-cto-advisor.md
View File

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

12
docs/agents/cs-demand-gen-specialist.md
View File

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

8
docs/agents/cs-product-analyst.md
View File

@@ -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.

62
docs/agents/cs-product-manager.md
View File

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

30
docs/agents/cs-product-strategist.md
View File

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

84
docs/agents/cs-project-manager.md
View File

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

32
docs/agents/cs-ux-researcher.md
View File

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

22
docs/agents/cs-workspace-admin.md
View File

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