promote-to-core
Skill9 starsChanged 7 months agoMITView on GitHub
Promote a hub-only pattern (a skill/agent/rule living only in .claude/) into the distributable core/.claude/ template so downstream projects can provision it. Codifies every convention — frontmatter standard, registry entry + hash + tier, dual-home classification, docs regen, the full CI gate, and landing — so the promotion is a 5-step recipe instead of a 30-step rediscovery. Use when the user says "promote X to core", "make X distributable", or "ship X to downstream projects".
- Commits and pushes
1 other project uses a version of this.
Adopted by
Most recently taken up by
- haskelium/openpreztheir own version, first seen Nov 15, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- haskelium/openprez★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository44 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- anthropic-multi-agent-research-system-skillSkill
- apply-selectionsSkill
- bootstrap-dogfood-projectSkill
- brainstormSkill
- branch-choiceSkill
- cc-adoption-scoutSkill
- claude-guardianSkill
- continueSkill
- end-sessionSkill
- executing-plansSkill
- five-advisorsSkill
- get-work-doneSkill
- git-branch-lifecycleSkill
- githubSkill
- grill-meSkill
- hook-transcript-fixture-testSkill
- instagramSkill
- linkedinSkill
- modern-data-pipeline-diagramSkill
- pattern-qualitySkill
- platform-event-live-probeSkill
- plugin-lifecycleSkill
- prompt-auto-enhanceSkill
- provision-reportSkill
- redditSkill
- review-new-claude-featuresSkill
- save-sessionSkill
- scan-discovery-reportSkill
- scan-repoSkill
- scan-urlSkill
- self-improveSkill
- skill-evaluatorSkill
- skill-masterSkill
- ssot-workflow-auditSkill
- start-sessionSkill
- synthesize-hubSkill
- synthesize-projectSkill
- twitter-xSkill
- verify-effect-at-destinationSkill
- workflow-doc-reviewerSkill
- writing-plansSkill
- writing-skillsSkill
- youtube-transcriptSkill
The file
We split this skill into the rules it gives an agent
5 rules. About 0 are common, 0 are distinctive, and 5 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 29
Verify the pattern currently lives ONLY in .claude/ (not already in core/.claude/).
- Very specific: line 32
Check for companion patterns: If the skill references HOOKS (or other skills/agents) that are NOT yet in core/, the promotion is a BUNDLE: …
- Very specific: line 95
Add <name> under the right class (e.g.
- Very specific: line 109
Run the entire local CI in an isolated context so its output never floods the session — dispatch the pre-git-merge-checker-agent and act on …
- Very specific: line 130
Every registry entry needs a tier.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Promote a Hub-Only Pattern to Distributable core/
Moves a pattern from .claude/ (hub-only operational) into core/.claude/ (the template
downstream projects provision), registers it, and lands it — all gates green. This is the
INTERNAL hub-only→both flow; it is NOT /synthesize-hub (which pulls patterns FROM
downstream projects INTO the hub). Read docs/HUB-CORE-SYNC.md for the scoping doctrine.
Only promote what downstream projects can actually use. Hub machinery (scan/synthesis/ governance skills, this skill, the checks-runner agent) stays hub-only. A pattern is promotable only if it is self-contained and portable (no hub-only path/script dependency).
STEP 1: Confirm it's promotable, pick the tier
- Verify the pattern currently lives ONLY in
.claude/(not already incore/.claude/). - Confirm it's portable: no reference to hub-only scripts (
dedup_check.py,collate.py, …),registry/,core/, or hub-only paths. If it depends on those, it is machinery — stop. - Check for companion patterns. If the skill references HOOKS (or other skills/agents) that
are NOT yet in
core/, the promotion is a BUNDLE: promote those companions too, or the distributed skill points at machinery that doesn't exist downstream. Each companion hook runs the same copy→register→dual-home pipeline AND must be wired intocore/.claude/settings.json(STEP 3 — copy the hook + add its entry to the right event block incore/.claude/settings.json, matching the hub's wiring). Verify with:comm -23 <(grep -o '[a-z-]*\.sh' SKILL.md|sort -u) <(ls core/.claude/hooks). - Choose
tier:must-have(core dev workflow) |nice-to-have(useful utility) |skip.
STEP 2: Bring the pattern file up to the registered standard
For a skill (SKILL.md), the quality gate REQUIRES these frontmatter fields:
name, description, type, allowed-tools, argument-hint, version.
typeMUST beworkfloworreference.workflowREQUIRES## STEP N:sections in the body (the validator fails a workflow with no steps).referenceMUST be read-only — noWrite/Editinallowed-tools.descriptionshould start with an action verb and include a "Use when…" clause.- SKILL.md must be ≤ 1000 lines (warns over 500).
- The prerequisites contract MUST be present before promotion: a
## Prerequisitessection (or an explicitPrerequisites: noneline), plus a## STEP 0: Preflightwhen any prerequisite is declared — verify every item (tools, credentials, files, services, AND user inputs) up front, hard-stop with the complete missing list, no mid-run input requests, no undeclared fallbacks. A skill enteringcore/ships to downstream projects where unattended runs are common — the contract is non-negotiable at this boundary. For an agent (*.mdinagents/): required frontmattername, description, model(ortools); match an existing core agent's shape. For a rule (*.mdinrules/): a scope declaration is required (# Scope: globalorglobs:frontmatter) and the file must fit the ≤100-line rule budget the pattern test enforces. For a hook (*.sh):bash -nclean, executable, and wired intocore/.claude/settings.jsonunder the right event block in STEP 3 (see the companion-hook bullet in STEP 1). Make the edits in the.claude/copy first; thecore/copy will be identical.
STEP 3: Copy into the core/ tree
mkdir -p core/.claude/skills/<name> # or core/.claude/agents, /rules, /hooks
cp -r .claude/skills/<name>/* core/.claude/skills/<name>/Copy EVERY file in the pattern dir (SKILL.md + any scripts/references), not just SKILL.md.
STEP 4: Register it in registry/patterns.json (minimal-diff!)
The registry hash is the normalized SHA256 of the file the locator resolves —
core/.claude/skills/<name>/SKILL.md for skills. Compute it with the repo's own function,
never by hand:
python -c "import sys;sys.path.insert(0,'scripts');from dedup_check import hash_pattern;print(hash_pattern('core/.claude/skills/<name>/SKILL.md'))"Then add the entry. Avoid the reformat trap: the file uses ensure_ascii=False and _meta
is NOT the last key — so load with OrderedDict, APPEND the new key (do not move _meta), and
dump ensure_ascii=False, indent=2. A naive json.load+json.dump re-escapes every em-dash
and reorders _meta, producing a 150-line diff. Required entry fields (copy an existing skill
entry's shape): hash, type:skill, category, version, source, discovered, last_updated,
dependencies, visibility, description, tags, changelog, tier. Bump _meta.total_patterns
(+1) and _meta.last_updated. Confirm the diff is tight: git diff --stat registry/patterns.json.
STEP 5: Classify the dual-home pair
The pattern now lives in BOTH .claude/ and core/.claude/ → it MUST be classified in
config/dual-home-resources.yml or the drift gate fails:
synced— the two copies are normalized-identical (the common case for a clean promotion).divergent— they intentionally differ; add a one-line reason. Add<name>under the right class (e.g.synced: skills:).
STEP 6: Regenerate docs
PYTHONPATH=. PYTHONUTF8=1 python scripts/generate_docs.py
PYTHONPATH=. PYTHONUTF8=1 python scripts/generate_workflow_docs.pyThis updates docs/, README.md counts, and may auto-add the pattern to
config/workflow-groups.yml (benign). An "orphan pattern" warning just means no workflow
group — non-blocking.
STEP 7: Run the full gate (dispatch pre-git-merge-checker-agent)
Run the entire local CI in an isolated context so its output never floods the session —
dispatch the pre-git-merge-checker-agent and act on its PASS/FAIL verdict. It runs:
dedup_check.py --validate-all, --secret-scan, workflow_quality_gate_validate_patterns.py,
pytest scripts/tests/ (incl. test_dual_home_sync.py). Fix any failure before landing.
STEP 8: Commit, push, land
.claude/ is gitignored — stage its files with git add -f; core/, registry/, config/,
docs/, README.md stage normally.
git add core/.claude/... registry/patterns.json config/dual-home-resources.yml config/workflow-groups.yml README.md docs/
git add -f .claude/skills/<name>/SKILL.md
git commit -m "feat(skill): promote <name> to distributable core/"
git push -u origin <branch>
bash "$(git rev-parse --show-toplevel)/.claude/hooks/session-git-landing.sh" land --waitConventions cheat-sheet (the things easy to rediscover)
- Hash =
dedup_check.hash_pattern(<core SKILL.md>); the locator preferscore/.claude/.... - Every registry entry needs a
tier.categoryis usuallycore(universal, no stack prefix). type: workflow⇒ must have## STEP N:headings.type: reference⇒ read-only tools.- Registry edit: append key, keep
_metain place,ensure_ascii=False— or you get a giant diff. - Hub-only patterns (machinery) are NOT registered and NOT promoted; only portable patterns are.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

