Feat/code to prd

.claude-plugin/marketplace.json

@@ -129,7 +129,7 @@
     {
       "name": "product-skills",
       "source": "./product-team",
-      "description": "12 product skills with 13 Python tools: product manager toolkit (RICE, PRDs), agile product owner, product strategist, UX researcher, UI design system, competitive teardown, landing page generator, SaaS scaffolder, product analytics, experiment designer, product discovery, roadmap communicator.",
+      "description": "14 product skills with 15 Python tools: product manager toolkit (RICE, PRDs), agile product owner, product strategist, UX researcher, UI design system, competitive teardown, landing page generator, SaaS scaffolder, product analytics, experiment designer, product discovery, roadmap communicator, code-to-prd, research summarizer.",
       "version": "2.1.2",
       "author": {
         "name": "Alireza Rezvani"

.claude/commands/plugin-audit.md

@@ -0,0 +1,153 @@
+---
+description: Run the full 8-phase plugin audit pipeline on a skill directory.
+---
+
+Run the comprehensive plugin audit pipeline on the skill at `$ARGUMENTS`. If no argument provided, ask the user for the skill path.
+
+Execute all 8 phases sequentially. Auto-fix non-critical issues. Only prompt the user for critical decisions (external dependencies, security findings, breaking changes).
+
+## Phase 1: Discovery
+
+1. Verify `$ARGUMENTS` exists and contains `SKILL.md`. If not, error and stop.
+2. Read `SKILL.md` frontmatter — extract `name`, `description`, `Category`, `Tier`.
+3. Detect components:
+   - `scripts/*.py` → Python tools (count them)
+   - `references/*.md` → reference docs (count them)
+   - `assets/` → templates/samples
+   - `expected_outputs/` → test fixtures
+   - `agents/*.md` → embedded agents
+   - `skills/*/SKILL.md` → sub-skills (compound skill)
+   - `.claude-plugin/plugin.json` → standalone plugin
+   - `settings.json` → command registrations
+4. Detect domain from path (`engineering/`, `product-team/`, `marketing-skill/`, etc.)
+5. Search `commands/` for a `.md` file matching the skill name.
+6. Display discovery summary.
+
+## Phase 2: Structure Validation
+
+Run:
+```bash
+python3 engineering/skill-tester/scripts/skill_validator.py $ARGUMENTS --json
+```
+
+Parse JSON. If score < 75:
+- Auto-fix missing frontmatter fields, missing section headings, missing directories.
+- Re-run. If still < 75, mark as FAIL but continue collecting results.
+
+## Phase 3: Quality Scoring
+
+Run:
+```bash
+python3 engineering/skill-tester/scripts/quality_scorer.py $ARGUMENTS --detailed --json
+```
+
+Parse JSON. If score < 60, report improvement roadmap items.
+
+## Phase 4: Script Testing
+
+If `$ARGUMENTS/scripts/` contains `.py` files, run:
+```bash
+python3 engineering/skill-tester/scripts/script_tester.py $ARGUMENTS --json --verbose
+```
+
+All scripts must PASS. If any script uses external imports, **ask the user** whether the dependency is acceptable.
+
+## Phase 5: Security Audit
+
+Run:
+```bash
+python3 engineering/skill-security-auditor/scripts/skill_security_auditor.py $ARGUMENTS --strict --json
+```
+
+Zero CRITICAL or HIGH findings required. **Do NOT auto-fix security issues** — report them to the user with file, line, pattern, and recommended fix.
+
+## Phase 6: Marketplace & Plugin Compliance
+
+### 6a. plugin.json
+If `$ARGUMENTS/.claude-plugin/plugin.json` exists:
+- Must be valid JSON
+- Only allowed fields: `name`, `description`, `version`, `author`, `homepage`, `repository`, `license`, `skills`
+- Version must be `2.1.2`
+- Auto-fix version mismatches and remove extra fields.
+
+### 6b. settings.json
+If `$ARGUMENTS/settings.json` exists:
+- Must be valid JSON
+- Version must match repo version
+- Each command in `commands` field must have a matching `commands/*.md` file
+
+### 6c. Marketplace entry
+Check `.claude-plugin/marketplace.json` for an entry with `source` matching `./$ARGUMENTS`. Verify version and name match.
+
+### 6d. Domain plugin.json
+Check the parent domain's `.claude-plugin/plugin.json` — verify skill count in description matches actual count. Auto-fix stale counts.
+
+## Phase 7: Ecosystem Integration
+
+### 7a. Cross-platform sync
+Verify skill appears in `.codex/skills-index.json` and `.gemini/skills-index.json`. If missing:
+```bash
+python3 scripts/sync-codex-skills.py --verbose
+python3 scripts/sync-gemini-skills.py --verbose
+```
+
+### 7b. Command integration
+If the skill has associated commands, verify:
+- Command `.md` has valid frontmatter
+- Command references the correct skill
+- Command is in `mkdocs.yml` nav
+Auto-fix missing nav entries.
+
+### 7c. Agent integration
+Check for embedded agents in `$ARGUMENTS/agents/`. Search `agents/` for cs-* agents that reference this skill. Verify references resolve.
+
+### 7d. Cross-skill dependencies
+Read SKILL.md for references to other skills (`../` paths, "Related Skills" sections). Verify each referenced skill exists.
+
+## Phase 8: Domain Code Review
+
+Based on the domain, apply the appropriate agent's review criteria:
+
+| Domain | Agent | Focus |
+|--------|-------|-------|
+| `engineering/` or `engineering-team/` | cs-senior-engineer | Architecture, code quality, CI/CD |
+| `product-team/` | cs-product-manager | PRD quality, user stories, RICE |
+| `marketing-skill/` | cs-content-creator | Content quality, SEO, brand voice |
+| `ra-qm-team/` | cs-quality-regulatory | Compliance, audit trail, regulatory |
+| `business-growth/` | cs-growth-strategist | Growth metrics, revenue impact |
+| `finance/` | cs-financial-analyst | Model accuracy, metric definitions |
+| Other | cs-senior-engineer | General code review |
+
+Read the agent's `.md` file for review criteria. Apply those criteria to the skill's SKILL.md, scripts, and references. Check:
+- Workflows are actionable and complete
+- Scripts solve the stated problem
+- References contain accurate domain knowledge
+- No broken internal links
+- Attribution present where required
+
+## Final Report
+
+Present all results in a structured summary:
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║  PLUGIN AUDIT REPORT: {skill_name}                         ║
+╠══════════════════════════════════════════════════════════════╣
+║  Phase 1 — Discovery          ✅ {type}, {domain}           ║
+║  Phase 2 — Structure          ✅ {score}/100 ({level})       ║
+║  Phase 3 — Quality            ✅ {score}/100 ({grade})       ║
+║  Phase 4 — Scripts            ✅ {n}/{n} PASS                ║
+║  Phase 5 — Security           ✅ PASS (0 critical, 0 high)   ║
+║  Phase 6 — Marketplace        ✅ plugin.json valid            ║
+║  Phase 7 — Ecosystem          ✅ synced                       ║
+║  Phase 8 — Code Review        ✅ passed                       ║
+║                                                              ║
+║  VERDICT: ✅ PASS                                            ║
+║  Auto-fixes: {n} | Warnings: {n} | Action items: {n}        ║
+╚══════════════════════════════════════════════════════════════╝
+```
+
+**Verdict rules:**
+- All phases pass → **PASS**
+- Only warnings → **PASS WITH WARNINGS**
+- Any blocker (structure <75, quality <60, script FAIL, security CRITICAL/HIGH, invalid plugin.json) → **FAIL**

.codex/skills-index.json

@@ -3,7 +3,7 @@
   "name": "claude-code-skills",
   "description": "Production-ready skill packages for AI agents - Marketing, Engineering, Product, C-Level, PM, and RA/QM",
   "repository": "https://github.com/alirezarezvani/claude-skills",
-  "total_skills": 162,
+  "total_skills": 163,
   "skills": [
     {
       "name": "contract-and-proposal-writer",
@@ -797,6 +797,12 @@
       "category": "product",
       "description": "Agile product ownership for backlog management and sprint execution. Covers user story writing, acceptance criteria, sprint planning, and velocity tracking. Use for writing user stories, creating acceptance criteria, planning sprints, estimating story points, breaking down epics, or prioritizing backlog."
     },
+    {
+      "name": "code-to-prd",
+      "source": "../../product-team/code-to-prd",
+      "category": "product",
+      "description": "|"
+    },
     {
       "name": "competitive-teardown",
       "source": "../../product-team/competitive-teardown",
@@ -1010,7 +1016,7 @@
       "description": "Marketing, content, and demand generation skills"
     },
     "product": {
-      "count": 13,
+      "count": 14,
       "source": "../../product-team",
       "description": "Product management and design skills"
     },

.codex/skills/code-to-prd

@@ -0,0 +1 @@
+../../product-team/code-to-prd