Skip to content
Shell
5.0 KB
Raw Blame

Skills Marketplace Completion Plan

Goal: Finish remaining skills, sync all to manifest, import to database, get marketplace live with all 187 skills.

Current State:

  • 179 SKILL.md files exist in ~/Development/id8/claude-settings/skills/
  • Only 20 skills in manifest (159 missing)
  • Target: 187 skills
  • 13 empty directories need resolution
  • 3 orphaned root-level files

Phase 1: Audit & Cleanup (~10 min)

Task 1.1: Resolve Empty Directories

Assignee: Main Claude (me) Files: ~/Development/id8/claude-settings/skills/

Empty directories to resolve:

  1. accounts-reconciler
  2. billing-manager
  3. contract-analyzer
  4. cost-optimizer
  5. financial-reporter
  6. incident-responder
  7. migration-planner
  8. performance-profiler
  9. procurement-assistant
  10. investor-relations
  11. security-scanner
  12. test-generator
  13. (verify 13th)

Action: Create SKILL.md files for all 13 empty directories (contributes to 187 target).

Task 1.2: Move Orphaned Files

Files to move:

  • billing-security-auditor.md → billing-security-auditor/SKILL.md
  • payment-flow-debugger.md → payment-flow-debugger/SKILL.md
  • subscription-lifecycle-manager.md → subscription-lifecycle-manager/SKILL.md

Phase 2: Create Remaining Skills (~20 min)

Target: 187 total After Phase 1: 179 + 13 (filled empty) = 192 (overshooting slightly is fine)

If we already hit 187+ after filling empty directories, skip this phase.

If under 187, create skills from these priority categories:

  • Code & Technical (ci-cd, docker, kubernetes)
  • Business Operations (compliance, regulatory)
  • Domain-Specific (healthcare, fintech)

Phase 3: Generate New Manifest (~15 min)

Task 3.1: Write Manifest Generator Script

Assignee: Main Claude Tool: Bash + Node/Python

Script logic:

  1. Walk ~/Development/id8/claude-settings/skills/ directory
  2. For each subdirectory with SKILL.md:
    • Parse YAML frontmatter
    • Extract: name, description, category, version, triggers, tags
    • Map to manifest schema
  3. Output new skills-manifest.json

Manifest Entry Schema:

{
  "slug": {
    "name": "Display Name",
    "description": "One-line description",
    "source": "repo",
    "repository": "eddiebe147/claude-settings",
    "path": "skills/slug",
    "installPath": "~/.claude/skills/slug",
    "category": "category-id",
    "version": "1.0.0",
    "triggers": []
  }
}

Task 3.2: Map Categories

Match SKILL.md category field to manifest categories:

  • writing → writing
  • technical → nextjs-stack or tooling
  • business → business-ops
  • design → ui-ux
  • etc.

Phase 4: Import to Database (~10 min)

Task 4.1: Run Import Script

cd ~/Development/id8/id8labs
npm run import:skills

The script reads from manifest and upserts to Supabase skills table.

Task 4.2: Verify Database

SELECT COUNT(*) FROM skills;  -- Should be 187+
SELECT category_id, COUNT(*) FROM skills GROUP BY category_id;

Phase 5: Verify Marketplace (~5 min)

Task 5.1: Check Live Site

Tool: Playwright MCP

  1. Navigate to https://id8labs.app/skills
  2. Verify skill count displayed
  3. Check category pages
  4. Verify search functionality

Task 5.2: Spot Check Skills

  • Pick 5 random skills
  • Verify they display correctly on marketplace

Tool Assignments

Phase Primary Tool Backup
Phase 1 Write tool + Bash -
Phase 2 Write tool fullstack-developer agent
Phase 3 Bash + Node script Manual JSON editing
Phase 4 Bash (npm run) Supabase MCP
Phase 5 Playwright MCP Manual browser

Critical Files

Read before execution:

  • ~/Development/id8/claude-settings/skills-manifest.json (current manifest)
  • ~/Development/id8/id8labs/scripts/import-skills-from-manifest.ts (import logic)
  • ~/Development/id8/id8labs/supabase/migrations/20260106_create_skills_marketplace.sql (schema)

Modify:

  • ~/.claude/skills-manifest.json (regenerate entirely)
  • ~/Development/id8/claude-settings/skills/*/SKILL.md (fill empty dirs)

Success Criteria

  • No empty skill directories
  • No orphaned root-level .md files
  • skills-manifest.json contains 187+ entries
  • Supabase skills table has 187+ rows
  • id8labs.app/skills displays all skills
  • Search and category filtering work

Estimated Duration

Phase Time
Phase 1: Audit & Cleanup 10 min
Phase 2: Create Remaining 20 min
Phase 3: Generate Manifest 15 min
Phase 4: Import to DB 10 min
Phase 5: Verify 5 min
Total ~60 min

Git Strategy

Branch: Create feature branch before starting

cd ~/Development/id8/claude-settings
git checkout -b feature/skills-marketplace-completion

Commits:

  1. After Phase 1: "fix: resolve empty directories and orphaned files"
  2. After Phase 2: "feat: add remaining skills to reach 187"
  3. After Phase 3: "feat: regenerate skills-manifest.json with all 187 skills"

PR: Create PR to main after all phases complete