Point-Don't-Dump Skill Refactor
Restructure any bloated skill.md into a lean YAML front matter router that points at reference files, so Claude loads knowledge only when needed.
Technical/Codingtechnicalcoding
by AgentVoltv1.0.0Published 1y ago
Free to sign up · every skill included with AgentVolt Pro
About this skill
name: point-dont-dump-skill-refactor description: Restructure any bloated skill.md into a lean YAML front matter router that points at reference files, so Claude loads knowledge only when needed.
Point-Don't-Dump Skill Refactor
What This Does
The creator explains progressive disclosure: only the skill name and description sit in context until Claude decides the skill is relevant, then it lazy-loads the skill.md body and any listed reference files. He shows how a 139-marketing-idea skill fits under the character limit by keeping ideas in a knowledge base MD file and having the process file just point at it.
What You Get
- Lean YAML front matter with name and description
- process-only skill.md body
- separated reference MD files for knowledge
- per-task conditional file loading
- character-limit-aware structure
Customize
- skill_name: the routable name
- trigger_description: exact phrases that activate the skill
- reference_files: list of knowledge MD files to lazy-load
- process_steps: high-level ordered steps only
- scripts_dir: optional executable scripts
Sample Output
The marketing-ideas skill keeps 139 tactics in a separate knowledge base file so the skill.md fits in context and only loads the relevant category on demand.
Target Audience
Skill builders whose skill.md files have grown past useful size
Source
SKILL.md preview
SKILL.md
---
name: point-dont-dump-skill-refactor
description: Restructure any bloated skill.md into a lean YAML front matter router that points at reference files, so Claude loads knowledge only when needed.
---
# Point-Don't-Dump Skill Refactor
## What This Does
The creator explains progressive disclosure: only the skill name and description sit in context until Claude decides the skill is relevant, then it lazy-loads the skill.md body and any listed reference files. He shows how a 139-marketing-idea skill fits under the character limit by keeping ideas in a knowledge base MD file and having the process file just point at it.
## What You Get
- Lean YAML front matter with name and description
… (sign up to view the full skill)Sign up to view, copy, and install the full skill