Skip to content

feat(skills): extract-general-pattern skill - #217

Merged
omars-lab merged 1 commit into
masterfrom
extract-general-pattern-skill
Jul 11, 2026
Merged

feat(skills): extract-general-pattern skill#217
omars-lab merged 1 commit into
masterfrom
extract-general-pattern-skill

Conversation

@omars-lab

Copy link
Copy Markdown
Owner

Adds the extract-general-pattern skill: turn ONE concrete /designs post (an imported HLD) into generalized, standalone /designs posts by disentangling the many reusable patterns intertangled inside it. Secret-scanned clean; touches only .claude/ + the CLAUDE.md skills-map row.

What it is

A judgment-guided authoring skill (no Node transformer, no hook, no Make target — like import-marketplace-plugin). The flow:

  1. DISENTANGLE — read the source, surface every distinct reusable pattern (name · where it lives · one-line reusable claim · proposed *-design kind + slug). The 7 recurring pattern shapes live in PATTERN-TYPES.md.
  2. AGREE — present candidates via AskUserQuestion; nothing is written before you pick.
  3. AUTHOR — one generalized standalone post per approved pattern, one at a time with a checkpoint. De-specify the business, keep the mechanism; no source: provenance / backlink; draft: true; de-em-dash; MDX-clean.
  4. HAND OFF to refine-design-post for the GENERALITY/CLARITY audit (the proof the leak is gone).

Files

  • .claude/skills/extract-general-pattern/SKILL.md
  • .claude/skills/extract-general-pattern/PATTERN-TYPES.md (living catalog of the pattern shapes)
  • CLAUDE.md skills-map row
  • The two design plans, committed alongside (matches the repo's tracked .claude/plans/ convention)

Deferred (explicitly, per the skill's "Not yet" section)

External-blog export, batch mode, a deterministic transformer, hub auto-cataloging — named as next steps, not built in v1.

Verification

All referenced skills/files resolve (verified against the post-refactor skill names — author-post, refine-design-post, import-co-design, import-marketplace-plugin, manage-hubs, blog-kinds.json, the em-dash hook). Frontmatter valid, name matches dir. No secrets.

🤖 Generated with Claude Code

https://claude.ai/code/session_01WRtyLha5c6gN3VJ6cEqRPu

… from a concrete /designs post into standalone general posts

A judgment-guided authoring skill (no transformer): read one concrete /designs post
(an imported HLD), DISENTANGLE every distinct reusable pattern intertangled inside
it, AGREE via AskUserQuestion on which become posts, then AUTHOR one generalized
standalone /designs post per approved pattern (one at a time, checkpoint between
each), handing each to refine-design-post for the GENERALITY/CLARITY audit.

- SKILL.md — the DISENTANGLE → AGREE → AUTHOR → HAND OFF → VALIDATE flow; the
  de-specify core move (strip the business, keep the mechanism); the standalone rule
  (no source: provenance, no backlink, draft: true); the de-em-dash / MDX-clean body
  rules; and the explicit DEFERRED list (external-blog export, batch mode, a
  deterministic transformer, hub auto-cataloging).
- PATTERN-TYPES.md — the living catalog of the 7 recurring pattern shapes worth
  extracting (decision method, decision record, pipeline, self-healing loop,
  use-case model, NFR strategy, diagram convention) + how to recognize each.
- Registered in the CLAUDE.md skills-map; the two design plans committed alongside.

Pairs with refine-design-post (the audit it hands to), import-co-design +
import-marketplace-plugin (which create the concrete posts it reads), author-post,
manage-hubs. References verified against the post-refactor skill names (author-post,
etc.). No secrets.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@omars-lab
omars-lab merged commit 5372ce2 into master Jul 11, 2026
2 checks passed
@omars-lab
omars-lab deleted the extract-general-pattern-skill branch July 11, 2026 19:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant