scriptoriumadmin/claude-skills
1
0
Fork 0
mirror of https://github.com/alirezarezvani/claude-skills.git synced 2026-10-07 02:58:13 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
1506 commits 6 branches 7 tags 44 MiB
Commit graph

3 commits

Author SHA1 Message Date
Ben Fairless
02c04e3d32
fix(frontmatter): repair 14 unloadable YAML blocks 
Twelve files had frontmatter that yaml.safe_load rejects, all from the same
cause: an unquoted plain scalar containing ": " inside description. Claude Code
responds by loading the body with empty metadata, so the skill keeps working
via /name but has no description for the model to match against, and the seven
affected agents (where name and description are required) may not load at all.

Eleven are fixed by quoting the existing scalar, leaving the text
byte-identical. design-system carries both ' and " so quoting would defeat the
repo's regex extractors in generate-docs.py and sync-codex-skills.py; its one
colon-space is reworded instead ("Precedence:" -> "Precedence is").

Two agents had no frontmatter at all and were being listed with a placeholder
description; both now declare name and description. tools is deliberately
omitted so they keep inheriting the full set, as before.

Assisted-by: Claude Code:claude-opus-5
 2026-08-03 08:55:36 +08:00
Claude
a42cb9bec4
feat(v2.8.0-sprint2-partial): add 4 sub-skills (capacity-planner, internal-comms, channel-economics, partnerships-architect) 
Partial Sprint 2 commit — 4 of 9 remaining sub-skills done. 5 more in-flight
(knowledge-ops, procurement-optimizer, commercial-policy, rfp-responder,
commercial-forecaster) will land in follow-up commit.

## New skills

### business-operations (+2)

- capacity-planner — Erlang-C queueing math for ops teams (CX/Support/CS/BizOps/
  IT ops/Finance ops). Pure-stdlib Erlang-C in log-space (avoids factorial
  overflow). 3 tools: capacity_modeler (P50/P90/P99 SLA breach + 4-tier risk
  band), utilization_analyzer (red-zone detection per Little's Law),
  hiring_sequencer (12-month quarterly plan with ramp + attrition + growth +
  span-of-control manager trigger). 5 industry profiles. Canon: Erlang 1909,
  Little 1961, Hopp & Spearman, Reinertsen, Kingman, Cleveland, ITIL, Armony.
  Distinct from vpe-advisor (eng-specific) and project-management (tracking).

- internal-comms — ADKAR + Kotter 8-step change comms. 3 tools:
  comms_template_filler (ADKAR-tagged 4-artifact package), change_announcement_
  builder (Kotter-labeled output with magnitude/tone validation — rejects
  celebratory framing on disruptive change, layoff keywords without disruptive
  magnitude), comms_calendar_builder (7-touchpoint sequencing with anti-pattern
  flags like Slack-only-for-layoff). 5 tone profiles. Canon: Hiatt (Prosci),
  Kotter, Bridges, Schein, McKinsey 7-S, Heath brothers, Lencioni, Edelman,
  Gallup, Welch & Jackson, IABC. Distinct from marketing-skill (external) and
  c-level-advisor/internal-narrative (strategic).

### commercial (+2)

- channel-economics — Direct vs partner-led economics. 3 tools:
  cost_to_serve_calculator (fully-loaded CTS per deal + per $ ARR, hidden-cost
  flags, inconsistent-allocation warnings), channel_roi_analyzer (3-lens ROI:
  Cash / LTV / Marginal with diminishing-returns inflection point + verdict
  DOUBLE-DOWN/MAINTAIN/DEFUND/EXIT), channel_mix_optimizer (effective LTV +
  payback + LTV-CAC, discrete grid-search constrained optimizer, sensitivity
  scenarios). 5 industry profiles. Canon: Skok, BVP, Tunguz, KeyBanc, Ramanujam,
  McBain, OpenView, Kaplan & Cooper, Horngren, McKinsey, BCG. Distinct from
  partnerships-architect (structure not economics) and revenue-operations.

- partnerships-architect — 5-tier partner classifier + joint GTM + revshare.
  3 tools: partner_tier_classifier (REFERRAL/RESELLER/OEM/SI/STRATEGIC with
  hard floors per tier — STRATEGIC requires ≥5 named accounts sourced +
  multi-year commit + dedicated resources), joint_gtm_planner (tier×motion
  compatibility matrix, refuses channel_led for REFERRAL, refuses white_label
  outside OEM), revshare_modeler (direct vs via-partner margin, recommended
  band by tier × contribution depth, break-even sourced-deal count, 3-yr NPV).
  5 industry profiles. Canon: Caro/HP, Chintagunta, Hessling, Forrester, IDC,
  Tzuo, Moore, MPN, AWS APN. Distinct from sales-engineer (tech sale) and
  ma-playbook (acquisition).

## Infrastructure (full Sprint 2 coverage)

- 9 new slash commands (one per Sprint 2 sub-skill): /cs:capacity-plan,
  /cs:internal-comms, /cs:knowledge-ops, /cs:procurement, /cs:partner-tier,
  /cs:channel-econ, /cs:commercial-policy, /cs:rfp-respond,
  /cs:commercial-forecast
- business-operations/.claude-plugin/plugin.json: skills array expanded
  to all 7 (orchestrator + 6 sub-skills)
- commercial/.claude-plugin/plugin.json: skills array expanded to all 8
  (orchestrator + 7 sub-skills)
- Domain CLAUDE.md + README.md updated with Sprint 2 skills
- .claude-plugin/marketplace.json: version 2.7.3 → 2.8.0, top-level
  description bumped to 328 skills across 14 domains, expanded keywords
  on both new plugins
- Master plan updated to reflect Sprint 2 in-progress

## Hard rules per skill (Matt Pocock discipline)

- Every SKILL.md ships a Forcing-question library section (5-7 cited
  canon-anchored questions, one-at-a-time discipline)
- Every Python tool is stdlib-only (verified: argparse, json, sys, pathlib,
  statistics, dataclasses, enum, math, re, collections only)
- Industry tuning via --profile on scoring tools
- All 12 new tools pass --help + --sample (exit 0)

## Sprint 2 remaining (next commit)

knowledge-ops (5W2H SOP+runbook + KB hygiene, context: fork)
procurement-optimizer (UNSPSC spend categorization + supplier consolidation)
commercial-policy (data-backed discount matrix + exception flow + linter)
rfp-responder (Shipley structured RFP/RFI/RFQ + winrate predictor, context: fork)
commercial-forecaster (4Q-weighted bookings + cohort NRR/GRR + funnel-confidence
                       with mandatory assumption disclosure)

https://claude.ai/code/session_015bBb4HzWCf5HH5QK2TGtnW
 2026-05-19 03:58:32 +00:00
Claude
7947638b31
feat(v2.8.0-sprint1): add business-operations + commercial top-level domains 
Two new top-level domain folders expanding the repo from 313 → 319 production
skills across 14 domains. Path-B 11-file contract per skill, stdlib-only Python
tools, Matt Pocock grill-with-docs discipline baked into every SKILL.md.

## New domains

- business-operations/ — internal-ops skills for BizOps leads, COO direct
  reports, vendor management, IT ops. Sprint 1 ships 3 skills:
  - business-operations-skills (orchestrator, context: fork)
  - process-mapper (BPMN + bottleneck + cycle-time, 4 industry profiles,
    Lean/TOC canon)
  - vendor-management (scorecard + SLA + 3rd-party risk, 4 industry profiles,
    Shared Assessments SIG-Lite, NIST SP 800-161, ISO/IEC 27036)

- commercial/ — per-deal-and-packaging skills. Sprint 1 ships 3 skills:
  - commercial-skills (orchestrator, context: fork)
  - pricing-strategist (5-model picker, Van Westendorp PSM with OPP/IDP/PMC/PME,
    packaging with 7 anti-pattern detectors, Ramanujam/Skok/Tunguz canon)
  - deal-desk (5-dim scorer, discount approval router, 10-pattern terms redliner,
    never auto-approves — every verdict names the human approver)

## Chaining via context: fork

Both domain orchestrators set context: fork in frontmatter so heavy ingestion
(vendor catalogs, RFP docs, process transcripts) stays out of the parent
session. Sub-skills opt into fork only when they ingest large artifacts
(vendor-management does, pricing-strategist and deal-desk do not).

## Matt Pocock grill discipline

Every Sprint 1 SKILL.md ships a "Forcing-question library" section: 5-7
questions, walked one at a time by the orchestrator (or /cs:grill-bizops,
/cs:grill-commercial), each with a recommended answer + canon citation.
Discipline derived from engineering/grill-me + engineering/grill-with-docs
(Matt Pocock, MIT).

## Hard rules per domain

- BizOps: every output is a recommendation, never an auto-decision.
- Commercial: pricing outputs model+range (never a single number); deal outputs
  route to a named human approver (never auto-approve); forecasts surface the
  conversion assumption explicitly.

## Agents + commands

- cs-bizops-orchestrator agent ("Where does the work spend most of its time
  waiting?")
- cs-commercial-orchestrator agent ("What's the margin on this deal at full
  discount?")
- 8 new slash commands: /cs:bizops, /cs:commercial, /cs:grill-bizops,
  /cs:grill-commercial, /cs:process-map, /cs:vendor-review, /cs:pricing-strategy,
  /cs:deal-review

## Verification

- All 12 new Python tools (4 skills × 3 each) pass --help and --sample
  smoke tests, exit 0
- Stdlib-only across the board
- 12 reference docs each cite ≥ 7 authoritative sources
- Marketplace registry: 57 → 59 plugins

## Sprint 2 (not in this PR)

- BizOps: capacity-planner, internal-comms, knowledge-ops, procurement-optimizer
- Commercial: partnerships-architect, channel-economics, commercial-policy,
  rfp-responder, commercial-forecaster

## Files

50 new files: 6 SKILL.md (2 orchestrators + 4 leaf) + 12 Python tools + 12
references + 4 asset templates + 2 plugin.json + 2 CLAUDE.md + 2 README.md +
2 cs-* agents + 8 slash commands + 1 master plan doc + marketplace.json +
root CLAUDE.md update.

Master plan: documentation/implementation/bizops-commercial-expansion-plan.md

https://claude.ai/code/session_015bBb4HzWCf5HH5QK2TGtnW
 2026-05-19 03:36:04 +00:00