fix: add root-level SKILL.md and .codex/instructions.md to all domains (#301)

Root cause: CLI tools (ai-agent-skills, agent-skills-cli) look for SKILL.md
at the specified install path. 7 of 9 domain directories were missing this
file, causing "Skill not found" errors for bundle installs like:
  npx ai-agent-skills install alirezarezvani/claude-skills/engineering-team

Fix:
- Add root-level SKILL.md with YAML frontmatter to 7 domains
- Add .codex/instructions.md to 8 domains (for Codex CLI discovery)
- Update INSTALLATION.md with accurate skill counts (53→170)
- Add troubleshooting entry for "Skill not found" error

All 9 domains now have: SKILL.md + .codex/instructions.md + plugin.json

Closes #301

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Reza Rezvani
2026-03-09 14:31:08 +01:00
parent 885fe8b023
commit ac845cf476
16 changed files with 829 additions and 15 deletions

View File

@@ -1,6 +1,6 @@
# Installation Guide - Claude Skills Library
Complete installation guide for all 53 production-ready skills across multiple AI agents and platforms.
Complete installation guide for all 170 production-ready skills across multiple AI agents and platforms.
## Table of Contents
@@ -43,6 +43,17 @@ cd claude-skills
./scripts/codex-install.sh
```
### For Gemini CLI Users
```bash
# Setup script for Gemini CLI
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills
./scripts/gemini-install.sh
```
Skills install to `.gemini/skills/` and are activated via `activate_skill(name="skill-name")`.
Skills install to `~/.codex/skills/`. See [OpenAI Codex Installation](#openai-codex-installation) for detailed instructions.
### For All Other Agents (Cursor, VS Code, Goose, etc.)
@@ -54,7 +65,7 @@ npx agent-skills-cli add alirezarezvani/claude-skills
This single command installs all skills to all supported agents automatically.
**What this does:**
- ✅ Detects all 53 skills automatically
- ✅ Detects all 170 skills automatically
- ✅ Installs to Claude, Cursor, Copilot, Windsurf, Cline, and 37+ other AI agents
- ✅ Works across all skill formats
@@ -79,12 +90,15 @@ This adds the skills library to your available marketplaces.
```bash
# Install by domain (bundles of skills)
/plugin install marketing-skills@claude-code-skills # 6 marketing skills
/plugin install engineering-skills@claude-code-skills # 18 engineering skills
/plugin install product-skills@claude-code-skills # 5 product skills
/plugin install c-level-skills@claude-code-skills # 2 C-level advisory skills
/plugin install marketing-skills@claude-code-skills # 42 marketing skills
/plugin install engineering-skills@claude-code-skills # 23 engineering skills
/plugin install engineering-advanced-skills@claude-code-skills # 25 advanced engineering skills
/plugin install product-skills@claude-code-skills # 8 product skills
/plugin install c-level-skills@claude-code-skills # 28 C-level advisory skills
/plugin install pm-skills@claude-code-skills # 6 project management skills
/plugin install ra-qm-skills@claude-code-skills # 12 regulatory/quality skills
/plugin install business-growth-skills@claude-code-skills # 4 business & growth skills
/plugin install finance-skills@claude-code-skills # 1 finance skill
```
### Install Individual Skills
@@ -494,6 +508,20 @@ sudo apt-get install nodejs npm
# Download from https://nodejs.org/
```
#### Issue: "Skill not found" when installing a domain bundle
**Solution:** Use `agent-skills-cli` (not `ai-agent-skills`) and specify the correct path:
```bash
# Install entire domain bundle
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team
# Or install individual skills
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team/senior-frontend
```
Note: The older `ai-agent-skills` package may not support bundle installation. Use `agent-skills-cli` instead.
#### Issue: "Failed to install skills"
**Solution:** Check network connection and permissions
@@ -629,9 +657,62 @@ rm -rf .cursor/skills/fullstack-engineer/
---
## Gemini CLI Installation
Gemini CLI users can install skills using the setup script below. This repository provides Gemini CLI compatibility through a `.gemini/skills/` directory with symlinks to all 165+ skills, agents, and commands.
### Setup Instructions
1. **Clone the repository:**
```bash
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills
```
2. **Run the Gemini setup script:**
```bash
./scripts/gemini-install.sh
```
This script performs the following:
- Scans all 9 domain folders for `SKILL.md` files.
- Scans the `agents/` folder for multi-agent persona definitions.
- Scans the `commands/` folder for predefined slash command workflows.
- Creates a `.gemini/skills/` directory with standardized subfolders for each.
- Generates a `skills-index.json` manifest for discovery.
3. **Activate Skills in Gemini CLI:**
Gemini CLI can now activate any of these 165+ skills by name. Use the `activate_skill` tool:
```javascript
// Activate a core skill
activate_skill(name="senior-architect")
// Activate a marketing specialist
activate_skill(name="content-creator")
// Activate a C-level advisor
activate_skill(name="cto-advisor")
// Activate a multi-agent persona
activate_skill(name="cs-engineering-lead")
// Activate a slash command workflow
activate_skill(name="tdd")
```
### Python CLI Tools
Every skill includes deterministic Python CLI tools in its `scripts/` folder. These use the standard library only and can be run directly from your terminal or by the Gemini CLI.
Example:
```bash
python3 marketing-skill/content-production/scripts/brand_voice_analyzer.py article.txt
```
---
## OpenAI Codex Installation
OpenAI Codex users can install skills using the methods below. This repository provides full Codex compatibility through a `.codex/skills/` directory with symlinks to all 43 skills.
OpenAI Codex users can install skills using the methods below. This repository provides full Codex compatibility through a `.codex/skills/` directory with symlinks to all skills.
### Method 1: Universal Installer (Recommended)
@@ -713,20 +794,20 @@ ls ~/.codex/skills/content-creator/
# Check total skill count
ls ~/.codex/skills/ | wc -l
# Should show: 53
```
### Available Categories
| Category | Skills | Examples |
|----------|--------|----------|
| **c-level** | 2 | ceo-advisor, cto-advisor |
| **engineering** | 18 | senior-fullstack, aws-solution-architect, senior-ml-engineer |
| **marketing** | 6 | content-creator, marketing-demand-acquisition, social-media-analyzer |
| **product** | 5 | product-manager-toolkit, agile-product-owner, ui-design-system |
| **c-level** | 28 | ceo-advisor, cto-advisor, cfo-advisor, executive-mentor |
| **engineering** | 23 | senior-fullstack, aws-solution-architect, senior-ml-engineer, playwright-pro |
| **engineering-advanced** | 25 | agent-designer, rag-architect, mcp-server-builder, performance-profiler |
| **marketing** | 42 | content-creator, seo-audit, campaign-analytics, content-strategy |
| **product** | 8 | product-manager-toolkit, agile-product-owner, saas-scaffolder |
| **project-management** | 6 | scrum-master, senior-pm, jira-expert, confluence-expert |
| **ra-qm** | 12 | regulatory-affairs-head, quality-manager-qms-iso13485, gdpr-dsgvo-expert |
| **business-growth** | 3 | customer-success-manager, sales-engineer, revenue-operations |
| **business-growth** | 4 | customer-success-manager, sales-engineer, revenue-operations |
| **finance** | 1 | financial-analyst |
See `.codex/skills-index.json` for the complete manifest with descriptions.
@@ -765,6 +846,6 @@ See `.codex/skills-index.json` for the complete manifest with descriptions.
---
**Last Updated:** February 2026
**Skills Version:** 1.0 (53 production skills)
**Last Updated:** March 2026
**Skills Version:** 2.1.1 (170 production skills across 9 domains)
**Universal Installer:** [Agent Skills CLI](https://github.com/Karanjot786/agent-skills-cli)

View File

@@ -0,0 +1,31 @@
# Business & Growth Skills — Codex CLI Instructions
When working on customer success, sales, or revenue tasks, use the business growth skill system:
## Routing
1. **Identify the task:** Customer health, sales engineering, revenue operations, or proposals
2. **Read the specialist SKILL.md** for detailed instructions
## Python Tools
All scripts in `business-growth/*/scripts/` are stdlib-only and CLI-first:
```bash
python3 business-growth/customer-success-manager/scripts/health_score_calculator.py --help
python3 business-growth/revenue-operations/scripts/pipeline_analyzer.py --help
```
## Key Skills by Task
| Task | Skill |
|------|-------|
| Customer health | customer-success-manager |
| RFP/PoC planning | sales-engineer |
| Pipeline analysis | revenue-operations |
| Proposals/contracts | contract-and-proposal-writer |
## Rules
- Load only 1-2 skills per request — don't bulk-load
- Use Python tools for scoring and metrics

56
business-growth/SKILL.md Normal file
View File

@@ -0,0 +1,56 @@
---
name: "business-growth-skills"
description: "4 production-ready business and growth skills: customer success manager with health scoring and churn prediction, sales engineer with RFP analysis, revenue operations with pipeline and GTM metrics, and contract & proposal writer. Python tools included (all stdlib-only). Works with Claude Code, Codex CLI, and OpenClaw."
version: 1.1.0
author: Alireza Rezvani
license: MIT
tags:
- business
- customer-success
- sales
- revenue-operations
- growth
agents:
- claude-code
- codex-cli
- openclaw
---
# Business & Growth Skills
4 production-ready skills for customer success, sales, and revenue operations.
## Quick Start
### Claude Code
```
/read business-growth/customer-success-manager/SKILL.md
```
### Codex CLI
```bash
npx agent-skills-cli add alirezarezvani/claude-skills/business-growth
```
## Skills Overview
| Skill | Folder | Focus |
|-------|--------|-------|
| Customer Success Manager | `customer-success-manager/` | Health scoring, churn prediction, expansion |
| Sales Engineer | `sales-engineer/` | RFP analysis, competitive matrices, PoC planning |
| Revenue Operations | `revenue-operations/` | Pipeline analysis, forecast accuracy, GTM metrics |
| Contract & Proposal Writer | `contract-and-proposal-writer/` | Proposal generation, contract templates |
## Python Tools
9 scripts, all stdlib-only:
```bash
python3 customer-success-manager/scripts/health_score_calculator.py --help
python3 revenue-operations/scripts/pipeline_analyzer.py --help
```
## Rules
- Load only the specific skill SKILL.md you need
- Use Python tools for scoring and metrics, not manual estimates

View File

@@ -0,0 +1,40 @@
# C-Level Advisory — Codex CLI Instructions
When working on executive or strategic tasks, use the C-level advisory system:
## Routing
1. **Start with** `c-level-advisor/chief-of-staff/SKILL.md` — it routes to the right executive role
2. **For onboarding:** Run `c-level-advisor/cs-onboard/SKILL.md` to create company-context.md
3. **For big decisions:** Use `c-level-advisor/board-meeting/SKILL.md` for multi-role deliberation
## Python Tools
All scripts in `c-level-advisor/*/scripts/` are stdlib-only and CLI-first:
```bash
python3 c-level-advisor/cfo-advisor/scripts/burn_rate_calculator.py --help
python3 c-level-advisor/cto-advisor/scripts/tech_debt_analyzer.py --help
python3 c-level-advisor/ciso-advisor/scripts/risk_quantifier.py --help
```
## Key Skills by Task
| Task | Skill |
|------|-------|
| Strategy questions | chief-of-staff (routes) |
| Tech decisions | cto-advisor |
| Financial analysis | cfo-advisor |
| Product strategy | cpo-advisor |
| Marketing strategy | cmo-advisor |
| Security risk | ciso-advisor |
| Operations | coo-advisor |
| Revenue growth | cro-advisor |
| Hiring/culture | chro-advisor |
| Hard decisions | executive-mentor |
## Rules
- Run cs-onboard first to create company-context.md
- Load only 1-2 skills per request — don't bulk-load
- Use Python tools for quantitative analysis

View File

@@ -0,0 +1,40 @@
# Engineering Skills — Codex CLI Instructions
When working on engineering tasks, use the engineering skill system:
## Routing
1. **Identify the domain:** Architecture, frontend, backend, DevOps, security, AI/ML, data, or QA
2. **Read the specialist SKILL.md** for detailed instructions
3. **Use Python tools** for scaffolding and analysis
## Python Tools
All scripts in `engineering-team/*/scripts/` are stdlib-only and CLI-first. Run them directly:
```bash
python3 engineering-team/senior-fullstack/scripts/project_scaffolder.py --help
python3 engineering-team/senior-security/scripts/threat_modeler.py --help
python3 engineering-team/senior-frontend/scripts/bundle_analyzer.py --help
```
## Key Skills by Task
| Task | Skill |
|------|-------|
| System design | senior-architect |
| React/Next.js | senior-frontend |
| API design | senior-backend |
| Full project scaffold | senior-fullstack |
| Test generation | senior-qa |
| CI/CD pipelines | senior-devops |
| Threat modeling | senior-security |
| AWS architecture | aws-solution-architect |
| Code review | code-reviewer |
| E2E testing | playwright-pro |
| Stripe payments | stripe-integration-expert |
## Rules
- Load only 1-2 skills per request — don't bulk-load
- Use Python tools for analysis and scaffolding

91
engineering-team/SKILL.md Normal file
View File

@@ -0,0 +1,91 @@
---
name: "engineering-skills"
description: "23 production-ready engineering skills covering architecture, frontend, backend, fullstack, QA, DevOps, security, AI/ML, data engineering, computer vision, and specialized tools like Playwright Pro, Stripe integration, AWS, and MS365. 30+ Python automation tools (all stdlib-only). Works with Claude Code, Codex CLI, and OpenClaw."
version: 1.1.0
author: Alireza Rezvani
license: MIT
tags:
- engineering
- frontend
- backend
- devops
- security
- ai-ml
- data-engineering
agents:
- claude-code
- codex-cli
- openclaw
---
# Engineering Team Skills
23 production-ready engineering skills organized into core engineering, AI/ML/Data, and specialized tools.
## Quick Start
### Claude Code
```
/read engineering-team/senior-fullstack/SKILL.md
```
### Codex CLI
```bash
npx agent-skills-cli add alirezarezvani/claude-skills/engineering-team
```
## Skills Overview
### Core Engineering (13 skills)
| Skill | Folder | Focus |
|-------|--------|-------|
| Senior Architect | `senior-architect/` | System design, architecture patterns |
| Senior Frontend | `senior-frontend/` | React, Next.js, TypeScript, Tailwind |
| Senior Backend | `senior-backend/` | API design, database optimization |
| Senior Fullstack | `senior-fullstack/` | Project scaffolding, code quality |
| Senior QA | `senior-qa/` | Test generation, coverage analysis |
| Senior DevOps | `senior-devops/` | CI/CD, infrastructure, containers |
| Senior SecOps | `senior-secops/` | Security operations, vulnerability management |
| Code Reviewer | `code-reviewer/` | PR review, code quality analysis |
| Senior Security | `senior-security/` | Threat modeling, STRIDE, penetration testing |
| AWS Solution Architect | `aws-solution-architect/` | Serverless, CloudFormation, cost optimization |
| MS365 Tenant Manager | `ms365-tenant-manager/` | Microsoft 365 administration |
| TDD Guide | `tdd-guide/` | Test-driven development workflows |
| Tech Stack Evaluator | `tech-stack-evaluator/` | Technology comparison, TCO analysis |
### AI/ML/Data (5 skills)
| Skill | Folder | Focus |
|-------|--------|-------|
| Senior Data Scientist | `senior-data-scientist/` | Statistical modeling, experimentation |
| Senior Data Engineer | `senior-data-engineer/` | Pipelines, ETL, data quality |
| Senior ML Engineer | `senior-ml-engineer/` | Model deployment, MLOps, LLM integration |
| Senior Prompt Engineer | `senior-prompt-engineer/` | Prompt optimization, RAG, agents |
| Senior Computer Vision | `senior-computer-vision/` | Object detection, segmentation |
### Specialized Tools (5 skills)
| Skill | Folder | Focus |
|-------|--------|-------|
| Playwright Pro | `playwright-pro/` | E2E testing (9 sub-skills) |
| Self-Improving Agent | `self-improving-agent/` | Memory curation (5 sub-skills) |
| Stripe Integration | `stripe-integration-expert/` | Payment integration, webhooks |
| Incident Commander | `incident-commander/` | Incident response workflows |
| Email Template Builder | `email-template-builder/` | HTML email generation |
## Python Tools
30+ scripts, all stdlib-only. Run directly:
```bash
python3 <skill>/scripts/<tool>.py --help
```
No pip install needed. Scripts include embedded samples for demo mode.
## Rules
- Load only the specific skill SKILL.md you need — don't bulk-load all 23
- Use Python tools for analysis and scaffolding, not manual judgment
- Check CLAUDE.md for tool usage examples and workflows

View File

@@ -0,0 +1,29 @@
# Engineering Advanced Skills — Codex CLI Instructions
When working on advanced engineering tasks, use the POWERFUL-tier skill system:
## Routing
1. **Identify the domain:** Architecture, CI/CD, databases, observability, agents, RAG, or security
2. **Read the specialist SKILL.md** for detailed instructions
## Key Skills by Task
| Task | Skill |
|------|-------|
| Agent architecture | agent-designer |
| RAG systems | rag-architect |
| MCP servers | mcp-server-builder |
| CI/CD pipelines | ci-cd-pipeline-builder |
| Database schema | database-designer |
| Performance tuning | performance-profiler |
| API review | api-design-reviewer |
| Monitoring/SLOs | observability-designer |
| Release management | release-manager |
| Security audit | skill-security-auditor |
| Tech debt | tech-debt-tracker |
## Rules
- Load only 1-2 skills per request — don't bulk-load
- These are advanced skills — combine with engineering-team/ core skills as needed

70
engineering/SKILL.md Normal file
View File

@@ -0,0 +1,70 @@
---
name: "engineering-advanced-skills"
description: "25 advanced POWERFUL-tier engineering skills covering agent design, RAG architecture, MCP servers, CI/CD pipelines, database design, observability, security auditing, release management, and platform operations. Works with Claude Code, Codex CLI, and OpenClaw."
version: 1.1.0
author: Alireza Rezvani
license: MIT
tags:
- engineering
- architecture
- agents
- rag
- mcp
- ci-cd
- observability
agents:
- claude-code
- codex-cli
- openclaw
---
# Engineering Advanced Skills (POWERFUL Tier)
25 advanced engineering skills for complex architecture, automation, and platform operations.
## Quick Start
### Claude Code
```
/read engineering/agent-designer/SKILL.md
```
### Codex CLI
```bash
npx agent-skills-cli add alirezarezvani/claude-skills/engineering
```
## Skills Overview
| Skill | Folder | Focus |
|-------|--------|-------|
| Agent Designer | `agent-designer/` | Multi-agent architecture patterns |
| Agent Workflow Designer | `agent-workflow-designer/` | Workflow orchestration |
| API Design Reviewer | `api-design-reviewer/` | REST/GraphQL linting, breaking changes |
| API Test Suite Builder | `api-test-suite-builder/` | API test generation |
| Changelog Generator | `changelog-generator/` | Automated changelogs |
| CI/CD Pipeline Builder | `ci-cd-pipeline-builder/` | Pipeline generation |
| Codebase Onboarding | `codebase-onboarding/` | New dev onboarding guides |
| Database Designer | `database-designer/` | Schema design, migrations |
| Database Schema Designer | `database-schema-designer/` | ERD, normalization |
| Dependency Auditor | `dependency-auditor/` | Dependency security scanning |
| Env Secrets Manager | `env-secrets-manager/` | Secrets rotation, vault |
| Git Worktree Manager | `git-worktree-manager/` | Parallel branch workflows |
| Interview System Designer | `interview-system-designer/` | Hiring pipeline design |
| MCP Server Builder | `mcp-server-builder/` | MCP tool creation |
| Migration Architect | `migration-architect/` | System migration planning |
| Monorepo Navigator | `monorepo-navigator/` | Monorepo tooling |
| Observability Designer | `observability-designer/` | SLOs, alerts, dashboards |
| Performance Profiler | `performance-profiler/` | CPU, memory, load profiling |
| PR Review Expert | `pr-review-expert/` | Pull request analysis |
| RAG Architect | `rag-architect/` | RAG system design |
| Release Manager | `release-manager/` | Release orchestration |
| Runbook Generator | `runbook-generator/` | Operational runbooks |
| Skill Security Auditor | `skill-security-auditor/` | Skill vulnerability scanning |
| Skill Tester | `skill-tester/` | Skill quality evaluation |
| Tech Debt Tracker | `tech-debt-tracker/` | Technical debt management |
## Rules
- Load only the specific skill SKILL.md you need
- These are advanced skills — combine with engineering-team/ core skills as needed

View File

@@ -0,0 +1,28 @@
# Finance Skills — Codex CLI Instructions
When working on financial analysis tasks, use the finance skill system:
## Python Tools
All scripts in `finance/financial-analyst/scripts/` are stdlib-only and CLI-first:
```bash
python3 finance/financial-analyst/scripts/ratio_calculator.py --help
python3 finance/financial-analyst/scripts/dcf_valuation.py --help
python3 finance/financial-analyst/scripts/budget_variance_analyzer.py --help
python3 finance/financial-analyst/scripts/forecast_builder.py --help
```
## Key Skills by Task
| Task | Skill |
|------|-------|
| Financial ratios | financial-analyst |
| DCF valuation | financial-analyst |
| Budget variance | financial-analyst |
| Forecasting | financial-analyst |
## Rules
- Always validate financial outputs against source data
- Use Python tools for calculations, not manual estimates

55
finance/SKILL.md Normal file
View File

@@ -0,0 +1,55 @@
---
name: "finance-skills"
description: "Production-ready financial analyst skill with ratio analysis, DCF valuation, budget variance analysis, and rolling forecast construction. 4 Python tools (all stdlib-only). Works with Claude Code, Codex CLI, and OpenClaw."
version: 1.0.0
author: Alireza Rezvani
license: MIT
tags:
- finance
- financial-analysis
- dcf
- valuation
- budgeting
agents:
- claude-code
- codex-cli
- openclaw
---
# Finance Skills
Production-ready financial analysis skill for strategic decision-making.
## Quick Start
### Claude Code
```
/read finance/financial-analyst/SKILL.md
```
### Codex CLI
```bash
npx agent-skills-cli add alirezarezvani/claude-skills/finance
```
## Skills Overview
| Skill | Folder | Focus |
|-------|--------|-------|
| Financial Analyst | `financial-analyst/` | Ratio analysis, DCF, budget variance, forecasting |
## Python Tools
4 scripts, all stdlib-only:
```bash
python3 financial-analyst/scripts/ratio_calculator.py --help
python3 financial-analyst/scripts/dcf_valuation.py --help
python3 financial-analyst/scripts/budget_variance_analyzer.py --help
python3 financial-analyst/scripts/forecast_builder.py --help
```
## Rules
- Load only the specific skill SKILL.md you need
- Always validate financial outputs against source data

View File

@@ -0,0 +1,35 @@
# Product Skills — Codex CLI Instructions
When working on product tasks, use the product skill system:
## Routing
1. **Identify the task:** Prioritization, strategy, UX, UI, competitor analysis, or SaaS scaffolding
2. **Read the specialist SKILL.md** for detailed instructions
## Python Tools
All scripts in `product-team/*/scripts/` are stdlib-only and CLI-first:
```bash
python3 product-team/product-manager-toolkit/scripts/rice_prioritizer.py --help
python3 product-team/product-strategist/scripts/okr_cascade_generator.py --help
```
## Key Skills by Task
| Task | Skill |
|------|-------|
| Feature prioritization | product-manager-toolkit |
| Sprint planning | agile-product-owner |
| OKR planning | product-strategist |
| User research | ux-researcher-designer |
| Design system | ui-design-system |
| Competitor analysis | competitive-teardown |
| Landing pages | landing-page-generator |
| SaaS boilerplate | saas-scaffolder |
## Rules
- Load only 1-2 skills per request — don't bulk-load
- Use Python tools for scoring and analysis

61
product-team/SKILL.md Normal file
View File

@@ -0,0 +1,61 @@
---
name: "product-skills"
description: "8 production-ready product skills: product manager toolkit with RICE prioritization, agile product owner, product strategist with OKR cascades, UX researcher, UI design system, competitive teardown, landing page generator, and SaaS scaffolder. Python tools included (all stdlib-only). Works with Claude Code, Codex CLI, and OpenClaw."
version: 1.1.0
author: Alireza Rezvani
license: MIT
tags:
- product
- product-management
- ux
- ui
- saas
- agile
agents:
- claude-code
- codex-cli
- openclaw
---
# Product Team Skills
8 production-ready product skills covering product management, UX/UI design, and SaaS development.
## Quick Start
### Claude Code
```
/read product-team/product-manager-toolkit/SKILL.md
```
### Codex CLI
```bash
npx agent-skills-cli add alirezarezvani/claude-skills/product-team
```
## Skills Overview
| Skill | Folder | Focus |
|-------|--------|-------|
| Product Manager Toolkit | `product-manager-toolkit/` | RICE prioritization, customer discovery, PRDs |
| Agile Product Owner | `agile-product-owner/` | User stories, sprint planning, backlog |
| Product Strategist | `product-strategist/` | OKR cascades, market analysis, vision |
| UX Researcher Designer | `ux-researcher-designer/` | Personas, journey maps, usability testing |
| UI Design System | `ui-design-system/` | Design tokens, component docs, responsive |
| Competitive Teardown | `competitive-teardown/` | Systematic competitor analysis |
| Landing Page Generator | `landing-page-generator/` | Conversion-optimized pages |
| SaaS Scaffolder | `saas-scaffolder/` | Production SaaS boilerplate |
## Python Tools
9 scripts, all stdlib-only:
```bash
python3 product-manager-toolkit/scripts/rice_prioritizer.py --help
python3 product-strategist/scripts/okr_cascade_generator.py --help
```
## Rules
- Load only the specific skill SKILL.md you need
- Use Python tools for scoring and analysis, not manual judgment

View File

@@ -0,0 +1,33 @@
# Project Management Skills — Codex CLI Instructions
When working on project management tasks, use the PM skill system:
## Routing
1. **Identify the task:** PM methodology, Scrum, Jira, Confluence, or Atlassian admin
2. **Read the specialist SKILL.md** for detailed instructions
## Python Tools
All scripts in `project-management/*/scripts/` are stdlib-only and CLI-first:
```bash
python3 project-management/senior-pm/scripts/project_health_dashboard.py --help
python3 project-management/scrum-master/scripts/velocity_analyzer.py --help
```
## Key Skills by Task
| Task | Skill |
|------|-------|
| Portfolio management | senior-pm |
| Sprint health | scrum-master |
| Jira automation | jira-expert |
| Knowledge bases | confluence-expert |
| Atlassian setup | atlassian-admin |
| Templates/layouts | atlassian-templates |
## Rules
- Load only 1-2 skills per request — don't bulk-load
- Use MCP tools for live Jira/Confluence operations when available

View File

@@ -0,0 +1,59 @@
---
name: "pm-skills"
description: "6 production-ready project management skills for Atlassian users: senior PM with portfolio management, scrum master with velocity forecasting, Jira expert with JQL mastery, Confluence expert, Atlassian admin, and template creator. MCP integration for live Jira/Confluence automation. Works with Claude Code, Codex CLI, and OpenClaw."
version: 1.0.0
author: Alireza Rezvani
license: MIT
tags:
- project-management
- jira
- confluence
- atlassian
- scrum
- agile
agents:
- claude-code
- codex-cli
- openclaw
---
# Project Management Skills
6 production-ready project management skills with Atlassian MCP integration.
## Quick Start
### Claude Code
```
/read project-management/jira-expert/SKILL.md
```
### Codex CLI
```bash
npx agent-skills-cli add alirezarezvani/claude-skills/project-management
```
## Skills Overview
| Skill | Folder | Focus |
|-------|--------|-------|
| Senior PM | `senior-pm/` | Portfolio management, risk analysis, resource planning |
| Scrum Master | `scrum-master/` | Velocity forecasting, sprint health, retrospectives |
| Jira Expert | `jira-expert/` | JQL queries, workflows, automation, dashboards |
| Confluence Expert | `confluence-expert/` | Knowledge bases, page layouts, macros |
| Atlassian Admin | `atlassian-admin/` | User management, permissions, integrations |
| Atlassian Templates | `atlassian-templates/` | Blueprints, custom layouts, reusable content |
## Python Tools
6 scripts, all stdlib-only:
```bash
python3 senior-pm/scripts/project_health_dashboard.py --help
python3 scrum-master/scripts/velocity_analyzer.py --help
```
## Rules
- Load only the specific skill SKILL.md you need
- Use MCP tools for live Jira/Confluence operations when available

View File

@@ -0,0 +1,39 @@
# RA/QM Skills — Codex CLI Instructions
When working on regulatory or quality management tasks, use the RA/QM skill system:
## Routing
1. **Identify the domain:** Regulatory (FDA/MDR), quality (ISO 13485), security (ISO 27001), or privacy (GDPR)
2. **Read the specialist SKILL.md** for detailed instructions
## Python Tools
All scripts in `ra-qm-team/*/scripts/` are stdlib-only and CLI-first:
```bash
python3 ra-qm-team/risk-management-specialist/scripts/risk_matrix_calculator.py --help
python3 ra-qm-team/gdpr-dsgvo-expert/scripts/gdpr_compliance_checker.py --help
```
## Key Skills by Task
| Task | Skill |
|------|-------|
| FDA submissions | regulatory-affairs-head |
| EU MDR compliance | mdr-745-specialist |
| FDA 510(k)/PMA | fda-consultant-specialist |
| ISO 13485 QMS | quality-manager-qms-iso13485 |
| QMS governance | quality-manager-qmr |
| Risk management | risk-management-specialist |
| CAPA management | capa-officer |
| Document control | quality-documentation-manager |
| ISO 13485 audits | qms-audit-expert |
| ISO 27001 ISMS | information-security-manager-iso27001 |
| ISO 27001 audits | isms-audit-expert |
| GDPR compliance | gdpr-dsgvo-expert |
## Rules
- Load only 1-2 skills per request — don't bulk-load
- Always verify outputs against current regulations

66
ra-qm-team/SKILL.md Normal file
View File

@@ -0,0 +1,66 @@
---
name: "ra-qm-skills"
description: "12 production-ready regulatory affairs and quality management skills for HealthTech/MedTech: ISO 13485 QMS, MDR 2017/745, FDA 510(k)/PMA, ISO 27001 ISMS, GDPR/DSGVO compliance, risk management (ISO 14971), CAPA, document control, and internal auditing. Python tools included (all stdlib-only). Works with Claude Code, Codex CLI, and OpenClaw."
version: 1.0.0
author: Alireza Rezvani
license: MIT
tags:
- regulatory
- quality-management
- iso-13485
- mdr
- fda
- iso-27001
- gdpr
agents:
- claude-code
- codex-cli
- openclaw
---
# Regulatory Affairs & Quality Management Skills
12 production-ready compliance skills for HealthTech and MedTech organizations.
## Quick Start
### Claude Code
```
/read ra-qm-team/regulatory-affairs-head/SKILL.md
```
### Codex CLI
```bash
npx agent-skills-cli add alirezarezvani/claude-skills/ra-qm-team
```
## Skills Overview
| Skill | Folder | Focus |
|-------|--------|-------|
| Regulatory Affairs Head | `regulatory-affairs-head/` | FDA/MDR strategy, submissions |
| Quality Manager (QMR) | `quality-manager-qmr/` | QMS governance, management review |
| Quality Manager (ISO 13485) | `quality-manager-qms-iso13485/` | QMS implementation, doc control |
| Risk Management Specialist | `risk-management-specialist/` | ISO 14971, FMEA, risk files |
| CAPA Officer | `capa-officer/` | Root cause analysis, corrective actions |
| Quality Documentation Manager | `quality-documentation-manager/` | Document control, 21 CFR Part 11 |
| QMS Audit Expert | `qms-audit-expert/` | ISO 13485 internal audits |
| ISMS Audit Expert | `isms-audit-expert/` | ISO 27001 security audits |
| Information Security Manager | `information-security-manager-iso27001/` | ISMS implementation |
| MDR 745 Specialist | `mdr-745-specialist/` | EU MDR classification, CE marking |
| FDA Consultant | `fda-consultant-specialist/` | 510(k), PMA, QSR compliance |
| GDPR/DSGVO Expert | `gdpr-dsgvo-expert/` | Privacy compliance, DPIA |
## Python Tools
17 scripts, all stdlib-only:
```bash
python3 risk-management-specialist/scripts/risk_matrix_calculator.py --help
python3 gdpr-dsgvo-expert/scripts/gdpr_compliance_checker.py --help
```
## Rules
- Load only the specific skill SKILL.md you need
- Always verify compliance outputs against current regulations