19 Commits

Author SHA1 Message Date
Amin Borghei 677a89dba1 docs(counts): refresh all surfaces to 339 skills / 17 domains / 774 tools (#23)
Propagate the real library size everywhere and unify the machine catalogs
behind one generator so they stop drifting independently.

- build_manifest.py is now single-source: one run regenerates cli/skills.json,
  registry.json, .gemini/skills-index.json (was 203) AND the website catalog
  skills.json (was 294). Per-skill entries gained license/category/subdomain/
  tools_count.
- website rebuilt from the fresh catalog: 339 skill pages, 17 domain pages,
  llms.txt, agents/commands, sitemap (counts now 339/17/774).
- prose updated: README, CLAUDE.md, CHANGELOG (4.10.0), mkdocs.yml, and the
  docs/ install + architecture pages.
- gh repo description updated to 339/17/774.

Note: the legacy committed site doc-pages (landing, getting-started, guides)
use an older custom design the current generators no longer emit; their
embedded aggregates are left for a separate site-tooling decision (mkdocs
Material migration vs. keep custom).
2026-06-29 20:17:49 +02:00
Amin Borghei ee6fb3760c feat(platforms): refresh cross-platform surface for 339 skills / 17 domains (#22)
Align every assistant-facing config with the real library (was 204 skills /
13 domains / 559 tools) and adopt newer platform features.

- configs: correct counts to 339/17/787 and drop dead dir refs
  (engineering-team/, marketing-skill/) across .cursorrules, .windsurfrules,
  .clinerules, .goosehints, AGENTS.md, GEMINI.md
- cursor: add modern .cursor/rules/*.mdc Project Rules (always-on overview,
  SKILL.md authoring, scripts/*.py conventions); keep .cursorrules as fallback
- claude marketplace: rewrite marketplace.json to v3.0.0 with all 17 domains
  as plugins and live counts; add the 9 missing per-domain plugin.json files
  and fix the 8 stale ones
- manifest: build_manifest.py now also emits .gemini/skills-index.json (was
  stuck at 203) from the same source as cli/skills.json + registry.json, so the
  three machine indexes can't drift; regenerated all three
2026-06-29 20:04:10 +02:00
Amin Borghei 4976386b9b feat(workflow): add workflow meta-skills domain + gate two borderline skills (#21)
New cross-domain `workflow/` domain with two process meta-skills (orthogonal
to the 16 content domains, they multiply their value):

- workflow/handoff: package in-progress work into a self-contained context
  doc so a teammate or fresh agent can continue; includes handoff_context.py
  (captures git state) and a fill-in template.
- workflow/skill-router: match a vague/cross-domain intent against the whole
  catalog and recommend the best-fit skill(s). route_skill.py ranks by token
  + multi-word phrase overlap over cli/skills.json — deterministic, no ML.

Both carry their own Clarify-First gate (Pattern 11).

Also, per a quality audit of the 297-skill gate rollout (verdict: 100% pass,
zero defects), gate two skills that were initially mis-skipped as advisory but
are in fact generative (consistent with already-gated peers):

- c-level-advisor/cfo-advisor (builds 3-year financial models)
- marketing/growth-marketer (designs A/B experiments, computes sample size)

- scripts/build_manifest.py: register the `workflow` domain
- regenerated cli/skills.json and registry.json (339 skills, 17 domains)
2026-06-22 17:51:16 +02:00
Brian Borghei 7a97fb6a57 perf(skills): refactor top 20 token-heavy skills to progressive disclosure
Move deep content from oversized SKILL.md bodies into load-on-demand
references/ files, so each skill's per-trigger cost drops sharply while
full knowledge stays available when a task needs it.

- 20 SKILL.md slimmed to lean maps (all now 1.0K-1.8K body tokens,
  down from 5.6K-18.6K); combined per-trigger cost ~155K -> ~28K tokens
- 70 new references/ files; content relocated verbatim (zero info loss)
- add scripts/skill_token_audit.py: stdlib tool scoring every skill on
  Tier-1/2/3 token cost and progressive-disclosure usage
- regenerate cli/skills.json + registry.json for bumped versions
2026-06-15 19:54:02 +02:00
Brian Borghei 9b42662cfc chore(meta): refresh bundles + manifest + registry for Tier 1-3
- bundles.json: 15 -> 20 bundles. Updated devops-team, growth-team,
  compliance-officer, ai-governance-kit (added CAIO), product-team.
  Added new bundles: saas-commercial-ops, ai-governance-kit (refresh),
  medical-device-compliance, research-stack, fractional-c-suite,
  customer-experience-stack, strategy-frameworks-kit, gtm-launch-kit.
- scripts/build_manifest.py: added "research" to DOMAINS list.
- cli/skills.json + registry.json: regenerated from sources.
  Now reports 337 skills across 16 domains.
2026-05-27 23:02:50 +02:00
Brian Borghei 505cb8e28f feat(pm): tier 1 — worked examples (54), data adapters (3), MCP tools (15)
Deepens the 54 PM skills from "documentation" to "tools you can actually
use today." Three coordinated additions:

1. WORKED EXAMPLES (~13,000 lines across 54 files)
   Every PM skill now has examples/<scenario>.md with a realistic
   company, the workflow applied, and the FULL generated artifact PMs
   can copy. Recurring fictional cast (Acme Analytics, Wayfinder,
   Northwind, Helix Platform, Pylon) makes scenarios cross-reference
   naturally. Highlights: full 8-section PRD for "Shared Dashboards",
   AI PRD with eval/guardrails/model-fallback, blameless RCA for a
   47-min payment outage, weekly Yellow-status exec update, 8-interview
   synthesis to opportunity tree, full Stripe CIRCLES answer.

2. LIVE DATA ADAPTERS (tools/adapters/)
   Three stdlib-only scripts that pull from real APIs and emit JSON
   in the shape PM Python tools expect. Removes the "first get the
   data" friction.
   - jira_to_json.py    -> raw / status-update / cycle-time / dependency-map
   - linear_to_json.py  -> raw / status-update / cycle-time / dependency-map
   - notion_to_json.py  -> raw / prds / okrs / roadmap / feedback
   Auth via env vars (JIRA_TOKEN, LINEAR_API_KEY, NOTION_TOKEN).
   Pipe directly into the consuming PM tool:
     jira_to_json.py --format cycle-time | flow_metrics.py --input -

3. MCP TOOLS (scripts/mcp_server.py)
   15 PM skills wrapped as Claude Code MCP tools, callable from inside
   any AI conversation without manually running Python. Each accepts
   `format` and `input`. Names: pm_create_prd, pm_status_update,
   pm_funnel_analyze, pm_flow_metrics, pm_dependency_map,
   pm_feedback_triage, pm_nsm_tree, pm_refinement_score,
   pm_interview_synthesize, pm_prioritize, pm_okr_validate,
   pm_roadmap_transform, pm_pre_mortem, pm_release_notes,
   pm_stakeholder_map. Smoke-tested end-to-end through JSON-RPC.

PM README updated with new sections for adapters and MCP. CHANGELOG
[4.5.0] entry added.
2026-05-22 11:30:48 +02:00
Brian Borghei 65d3aa8cbf feat(pm): expand project-management to 42 skills — most-used domain
Wide push of 17 new PM skills + skeleton across discovery, execution, career,
and integrations. PM is now the deepest and most-visited domain in the library.

New skills:
- discovery: interview-synthesis (transcript -> opportunity solution tree)
- execution: prfaq, backlog-refinement, status-update-generator,
  north-star-metric, roadmap-communication, beta-program, launch-playbook,
  cycle-time-analyzer, dependency-map, story-splitting
- career (new sub-domain): pm-interview-prep, pm-career-ladder,
  pm-onboarding, pm-1on1s
- integrations: linear-expert (Linear GraphQL + Jira migration patterns),
  notion-pm (Notion DB design for PRDs/OKRs/Roadmap/Decisions)

Foundation:
- SHARED_OUTPUT_SCHEMA.md defines --format json|markdown|mermaid|confluence|
  notion|linear convention all PM Python tools follow
- project-management/examples/feature-end-to-end.md worked end-to-end scenario
- Role-based Quick Start in PM README (APM -> CPO, 7 role entry points)
- 4 new bundles in bundles.json: pm-starter-pack, pm-scrum-master,
  pm-discovery-coach, pm-career-track

Fixes:
- scripts/build_manifest.py now recurses one level into container folders
  (discovery/, execution/, career/) so nested skills appear in the registry.
  Previously the registry undercounted PM by ~30 nested skills.
- .claude/settings.json hook commands use \$CLAUDE_PROJECT_DIR instead of
  relative paths so they work regardless of CWD.

Bolded PM as the most-visited domain in README.md, CLAUDE.md, docs/SKILLS.md,
and project-management/{README,CLAUDE}.md. Reconciled skill count across all
index files: 282 total, 42 PM.
2026-05-21 23:22:34 +02:00
Brian Borghei 40998aacc2 feat(registry): publish canonical registry.json and include missing domains
Adds registry.json at repo root as the public-facing index third-party
indexers can consume. Slimmer schema than cli/skills.json (no file
lists or sizes — those stay in the internal CLI manifest).

Also fixes a latent bug in scripts/build_manifest.py: the DOMAINS list
was missing documents, personal-productivity, and vertical-advisors,
silently dropping 21 skills from cli/skills.json. Total is now 250
skills across 15 domains.

Both manifests are now generated from the same walk in one pass, so
they stay in sync.
2026-05-18 12:41:51 +02:00
Brian Borghei af910eb910 feat(bundles): add 5 Claude Code plugin bundles
5 curated plugin bundles ready for submission to
anthropics/claude-plugins-official as external plugins.

Bundles:
- engineering-skills (8 flagship): fullstack, devops, security, docker,
  terraform, mcp-server-builder, rag-architect, code-reviewer
- compliance-skills (9 flagship): ISO 27001, SOC 2, GDPR, EU AI Act,
  NIS2, DORA, ISO 13485, MDR, FDA
- c-level-skills (7 flagship): CEO/CTO/CFO/CISO/CMO advisors plus
  board-meeting and board-deck-builder
- marketing-skills (6 flagship): content-creator, seo-audit, demand
  acquisition, campaign-analytics, landing-page-generator, x-twitter
- product-skills (6 flagship): product-manager-toolkit, strategist,
  agile-product-owner, product-designer, ux-researcher, design-system

Each bundle has .claude-plugin/plugin.json per Anthropic's external
plugin schema, a README, and symlinks into the canonical skill
directories. Symlinks keep a single source of truth for skill content;
scripts/export_bundle.py dereferences them for self-contained exports
when submitting PRs to the Anthropic registry.

Total: 44 KB repo addition, 36 symlinks.
2026-04-19 15:52:35 +02:00
Brian Borghei 9e2bc06178 feat(cli): add claude-skills npm package (v0.1.0)
npx claude-skills add <skill> installs any skill from the library into
the detected AI assistant in one command. Auto-detects Claude Code,
Cursor, Codex, Gemini CLI, Copilot, Windsurf, Cline, Aider, Goose via
marker files. Pure Node.js (18+), no Python required for end users.

Commands: list, search, info, add, create, update, remove.

Adds:
- scripts/build_manifest.py: stdlib-only Python that walks domain
  folders and emits cli/skills.json (229 skills, 12 domains indexed)
- cli/: npm package with commander + kleur, 10 passing tests
- .github/workflows/build-manifest.yml: regenerates manifest on
  SKILL.md changes, auto-commits
- .github/workflows/publish-cli.yml: publishes to npm on cli-v* tag,
  supports dry_run via workflow_dispatch
2026-04-19 15:01:37 +02:00
Amin Borghei 0ffa001378 fix(site): improve "Add to My AI" prompt to give full copyable skill text
The prompt now explicitly instructs the AI to:
- Provide the complete skill definition in a ready-to-copy code block
- Never say "paste from above" or "scroll up"
- Auto-detect the platform (Claude.ai vs ChatGPT vs other)
- Give exact step-by-step instructions with the actual text to paste
- Include a real test prompt from the skill's workflows
2026-04-10 14:16:03 +02:00
Amin Borghei 68ad61c82c feat(site): add "Try in Chat" + "Add to My AI" dual prompt system
Every skill page now has two copy-paste options:

- **Try in Chat** (Quick) -- condensed prompt for instant one-off use
  in any AI chat. No setup needed.

- **Add to My AI** (Full Skill) -- complete SKILL.md content with
  step-by-step instructions for the AI to help create a persistent
  Claude Project or Custom GPT. The AI walks the user through setup
  on their specific platform.

Both prompts are auto-generated from each SKILL.md. The "Add to My AI"
prompt includes the full skill definition so the created project has
complete expertise, workflows, templates, and frameworks.
2026-04-10 11:14:44 +02:00
Amin Borghei fc9b05f14d feat(site): add copy-paste prompts to all skill pages for beginners
Every skill page now has a "Quick Start" tab (default) with a one-click
"Copy Prompt" button. Users can paste the generated prompt directly into
claude.ai, ChatGPT, or any AI chat to get that skill's expertise
instantly -- no repo setup, no CLI, no configuration needed.

- Auto-generates condensed prompts from each SKILL.md
- Prompt includes key capabilities, frameworks, and guidance
- Copy button with visual feedback (turns green on copy)
- Scrollable preview of the full prompt
- "Quick Start" is the default tab on all 244 skill pages
2026-04-10 02:36:42 +02:00
Amin Borghei 796411ea55 feat(site): generate legal domain pages and new PM skill pages
- Added legal domain to site generator (DOMAIN_META)
- Generated 18 legal skill pages + domain index
- Generated 3 new PM skill pages (daci-framework, eol-communication, story-mapping)
- Updated sitemap.xml and llms.txt
2026-04-10 02:25:48 +02:00
Brian Borghei 3daa0bbe90 feat: regenerate 241 site pages with claude.ai warm minimal theme
All skill pages, category pages, agents, and commands pages
rebuilt with cream backgrounds, terracotta accent, SVG icons,
serif headings, AI platform selector tabs, and editorial layout.
2026-04-02 22:03:44 +02:00
Brian Borghei d83e68bb90 feat: v4.0.0 — 225 skills, personas, compound sub-skills, Gemini CLI, full website
Major release adding 21 new skills, 7 personas, 21 slash commands,
3 compound sub-skill systems, Gemini CLI support, 5 CI/CD workflows,
MCP server, CLI tool, quality scorer, MkDocs docs site, and full
static website with 241 pages (individual skill pages with SEO,
JSON-LD structured data, badges/labels, and llms.txt).

New skills: docker-development, terraform-patterns, helm-chart-builder,
a11y-audit, sql-database-assistant, threat-detection, google-workspace-cli,
ai-security, browser-automation, focused-fix, llm-cost-optimizer,
prompt-governance, secrets-vault-manager, red-team, snowflake-development,
agenthub, saas-metrics-coach, business-investment-advisor,
video-content-strategist, x-twitter-growth, ab-test-setup.

Infrastructure: cs CLI, MCP server, quality scorer, integration test runner,
skill scaffolder, skill graph, starter bundles, sample data/fixtures,
orchestration protocol, skill authoring standard, CONTRIBUTING.md.

Quality audit: 22 engineering skills refined (67-78% token reduction on
bloated skills, trigger clauses, agent voice, anti-patterns on mid-range).

Stats: 204→225 skills, 559→613 tools, 17→32 agents, 5→26 commands.
2026-04-02 21:54:31 +02:00
Brian Borghei deb73d4795 feat: v3.0 infrastructure — restructure, agents, config updates, website
WS1: Update all 7 config files (230+ → 559 Python tools)
- CLAUDE.md, AGENTS.md, .cursorrules, .windsurfrules, .clinerules,
  .goosehints, .github/copilot-instructions.md

WS2: Repository restructure
- Merge engineering-team/ (28 skills) into engineering/ (now 61 skills)
- Rename marketing-skill/ to marketing/
- Move INSTALLATION.md, AUDIT_REPORT.md to docs/
- Fix 100+ file references to old directory names

WS3: Agent system overhaul
- Upgrade 6 .claude/agents/ with skill-powered analysis (measurable scores)
- Create 8 new role-based agents: cs-tech-lead, cs-engineering-director,
  cs-cfo-advisor, cs-ciso-advisor, cs-cmo-advisor, cs-privacy-officer,
  cs-growth-lead, cs-design-lead

WS6: GitHub Pages website
- Minimal dark theme site at site/
- Inter + JetBrains Mono fonts
- Terminal typing animation, scroll counters, domain grid
- Pure HTML/CSS/JS, no dependencies
2026-03-21 17:56:47 +01:00
Amin Borghei e0c2be7e12 feat: major upgrade to 97 skills, 178 tools, 6 subagents, 12 workflows
- Add 3 new skills: claude-code-mastery, codex-cli-specialist, devops-workflow-engineer
- Add 6 Claude Code subagents: code-reviewer, doc-generator, qa-engineer, changelog-manager, security-auditor, git-workflow
- Add 6 GitHub workflows: documentation-check, qa-validation, changelog-enforcer, skill-validation, release-drafter, skill-auto-update
- Add skill-installer.py CLI with per-group install and auto-update support
- Upgrade senior-devops (210→1198 lines) and senior-mobile (3 scripts, 3 references)
- Add YAML frontmatter to 12 SKILL.md files (100% coverage)
- Add domain CLAUDE.md for data-analytics, hr-operations, sales-success
- Rewrite README with accurate counts, subagents section, workflows section
- Update INSTALLATION.md with Skill Installer CLI and auto-update docs
- Update repo metadata: homepage → borghei.me, 16 topics
2026-02-27 22:41:42 +01:00
Amin Borghei c6120ca771 Fully upgrade repo: 93 skills, 92+ Python tools, 11 domains
- Upgrade from 47 basic skills to 93 production-ready skill packages
- Add 92+ Python CLI automation tools (standard library only)
- Add engineering-team/ (21 skills) and engineering/ (11 advanced skills)
- Add c-level-advisor/, marketing-skill/, product-team/, project-management/
- Add ra-qm-team/ (12 regulatory/quality skills), business-growth/, finance/
- Preserve unique domains: data-analytics/, hr-operations/, sales-success/
- Add .claude/ slash commands, .codex/ Codex compatibility, .github/ CI/CD
- Add agents/, standards/, templates/, documentation/
- Add marketplace plugin system with 14 bundles
- Add full documentation: CLAUDE.md, CONTRIBUTING, SECURITY, INSTALLATION
- Add SVG header banner to README
2026-02-21 22:43:38 +01:00