Agent skill
flesh-out
Transform raw/crude document drafts into structured content. Use when a document is a skeleton of ideas, notes, or stream-of-consciousness that needs generative expansion rather than review polish.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/flesh-out
SKILL.md
This skill is for generative work on crude/raw content at $ARGUMENTS - not polishing drafts.
Stop after each stage and have changes reviewed with user.
Note: The developer's raw content captures intent. The agent expands and structures but must preserve the developer's meaning. When uncertain about intent, ask - don't assume.
See
responsibilities.mdfor the full agent/developer ownership matrix.
-
Extract core ideas (developer leads)
- Read the raw content and identify the key concepts
- List what the developer appears to be saying (don't fix typos yet)
- Confirm understanding with developer before proceeding
- Identify gaps: "You mention X but don't explain Y - should I research this?"
-
Research and expand (agent leads with approval)
- Web search for external concepts if applicable
- Find industry terminology for rough ideas
- Identify related work the developer may want to reference
- Propose expansions - developer approves what to include
- Verify every reference before presenting: fetch URLs, confirm they resolve, confirm the source supports the claim. Do not present unverified links to the developer.
-
Structure the content (agent leads with approval)
- Determine appropriate document structure (based on template if available)
- Organize ideas into logical sections
- Create hierarchy (headers, sub-sections)
- Add diagrams or tables where relationships exist
-
Polish language (agent leads with approval)
- Fix spelling, grammar, terminology
- Expand acronyms on first use
- Ensure consistent usage throughout
- Add links to external references (verify each URL resolves before adding)
-
Tidy up (agent leads with approval)
- Check with the user where to update the glossary
- Add terms that needed clarification
- Update references with new links
When to Use This vs Other Skills
| Document State | Use |
|---|---|
| Raw notes, bullet points, stream of consciousness | flesh-out |
| Typos, incomplete sentences, but has structure | review-steps |
| Structured but missing sections | flesh-out (or discuss scope first) |
| Complete draft needing polish | review-steps |
| Complete draft needing critical evaluation | strong-edit |
Key Difference from Review
Review improves what exists within its structure. Flesh-out creates structure from raw ideas.
Review a skeleton -> correct but incomplete document. Flesh-out a skeleton -> complete document.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?