01-projects/phdata

Skill Development Pipeline — Plan

2026-06-27·build-plan·status: proposal
phdataskillspipelinecowork-intensiveskill-creatorthin-harness-fat-skills

The ask: a good, reusable skill-development pipeline. First big use case: Andrew's "Claude Cowork Intensive" departmental-stripes grid (~60 named skills across Marketing / Finance / Sales / Operations / Legal …, anchored to top certs per discipline).

TL;DR

The principle (why this shape)

Thin harness, fat skills. A skill's value is the hard-won domain procedure baked into it — not the boilerplate. The slop-cannon failure mode is letting the model "flesh out" a skill from just its name: you get 60 plausible-sounding, generic skills with no real depth. The whole pipeline is built to force depth in (from the cert source) and gate slop out (via independent critics).

The pipeline — 4 seats, run per skill

We already have these as domain-agnostic skills (pipeline-spec-author, -test-author, -code-author, -critic). We point them at "skill" as the artifact type.

  1. Spec — input: {skill name, one-line purpose, department + block context, cert-competency excerpt}. Output: a build spec — the procedure the skill must encode, its triggers, inputs/outputs, and a progressive-disclosure file plan. This is where cert knowledge → agent procedure translation happens.
  2. Tests / acceptance contract — reads the spec only (independent of implementation). Output: concrete scenarios the skill must handle, trigger-accuracy cases (fires on the right asks, not the wrong ones), and a fat-content check (encodes real workflow steps, not generic advice).
  3. Author — reads spec + tests. Writes the SKILL.md + reference files. skill-creator runs here as the scaffolding engine (consistent shape, description tuning).
  4. Critic — fans out one sub-agent per axis, returns PASS/FAIL + confidence into a convergence loop (FAIL → back to author with notes, up to N rounds). Axes:
    • Triggering precision (skill-creator's eval/benchmark — does it fire correctly?)
    • Domain fidelity vs the cert competency (is the procedure actually right?)
    • Procedure-not-knowledge-dump (workflow steps, not a syllabus restatement)
    • Progressive-disclosure hygiene (size, file layout, lazy pointers)
    • No-slop (specificity over plausible-generic)

Output per skill: the SKILL.md + a pre-registered acceptance contract + a critic verdict + an eval score.

Scaling to the grid (the fan-out)

~60 skills on a regular structure is a fan-out, not a 60× manual click-through. Run a pipeline() over the skill list — each skill flows spec → tests → author → critic independently (no barrier between stages), so wall-clock ≈ the slowest single skill, not the sum. Batch by department so each discipline's cert anchor is loaded once.

Quality gates (human-in-the-loop)

Cert-anchor strength map (starting hypothesis — validate with Andrew)

The anchor is uneven, and that determines how much we can lean on it:

What exists vs what I build

Distribution (where the skills land)

Per the CAF architecture call: two rails — org-admin-published skills (Cowork/Desktop/web, the dominant rail for the ~60 sales/ops users) + the Code plugin (the engineers). The pipeline produces the SKILL.md artifacts; distribution is the existing phData plugin/marketplace decision.

The pilot

Open questions for founder / Andrew

  1. Cert source access — do we have the actual competency outlines/BOKs per discipline, or do we work from public cert syllabi + practitioner sources?
  2. Where do built skills live — phData Cowork org-published rail, the Code plugin, or both, for the Intensive?
  3. Weak-anchor disciplines (Sales, Marketing) — supplement with practitioner-workflow sources, or accept tool-centric v1 and iterate?
  4. Relationship to CAF's 106-skill collapse — is this the same skill-authoring engine, or a separate track? (My instinct: same engine, different artifact set.)