narrative-inventory
Skill1 starsChanged 13 months agoApache-2.0View on GitHub
Create writing inventories using William Germano's framework to help writers understand what they have, identify gaps, and maintain focus during revision
In this repository23 other files it gives its agents.
- app-runnerSkill
- delegateSkill
- env-managerSkill
- lexical-recall-guardSkill
- narrative-keywordsSkill
- narrative-mapsSkill
- obsidian-apiSkill
- obsidianSkill
- project-indexerSkill
- skill-api-conversionSkill
- skill-creatorSkill
- skill-distillSkill
- slipbox-integrationSkill
- story-structure-22-step-apiSkill
- story-structure-22-step-distilledSkill
- story-structure-22-stepSkill
- story-structure-7-stepsSkill
- story-structure-crime-distilledSkill
- story-structure-crimeSkill
- story-structure-myth-distilledSkill
- story-structure-mythSkill
- symbol-webSkill
- webapp-testingSkill
The file
We split this skill into the rules it gives an agent
12 rules. About 0 are common, 10 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈10
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 35
When this skill is invoked, follow these steps to create an inventory.
- Distinctive: line 44
Ask which draft or section to inventory
- Distinctive: line 47
Read the draft text to understand scope and content
- Distinctive: line 72
Create the appropriate inventory type(s)
- Distinctive: line 74
Use the writer's language and concepts where possible
- Distinctive: line 80
Keep items brief, sometimes fragmentary, in the writer's thinking voice
- Very specific: line 96
Ask where to save inventories (suggest inventories/ or process/inventories/)
- Distinctive: line 97
Create the chosen directory if it doesn't exist
- Very specific: line 99
Use the structure from assets/inventory-template.md
- Distinctive: line 103
Create the inventory as a formatted markdown artifact or downloadable file
- Distinctive: line 115
Multiple iterations: Create new inventories as the draft evolves
- Distinctive: line 121
Create outlines or hierarchical structures
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 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
Narrative Inventory
This skill helps writers inventory their draft text using William Germano's framework from On Revision. Inventories are "lists of things" that help writers understand what they have, what they're trying to do, and what might be missing or overemphasized.
Purpose
An inventory at the draft stage is a reminder, a "to-do-or-at-least-don't-forget-about" list. Inventories help writers keep fresh in mind what's important about their subject, remember what's driving them, identify what they want to share, see where the draft is heading, find significant points and themes, and understand what belongs and what doesn't.
When to Invoke This Skill
Invoke this skill when writers need to:
- Begin revision of a draft
- Understand what's actually been written vs. what was intended
- Identify gaps or overemphasized areas
- Refocus on the core purpose and direction of the piece
- Plan what still needs to be developed
- Feel lost in the prose of their own draft
Bundled Resources
References:
references/germano-framework.md- Detailed explanation of inventory types (Simple Topic, Topic with Concerns, Objectives/Ambitions, Memoranda), principles, and examples from Germano's framework
Assets:
assets/inventory-template.md- Template for inventory outputassets/example-inventory.md- Complete example based on Germano's liquorice essay illustration
Task Instructions
When this skill is invoked, follow these steps to create an inventory.
Step 1: Detect Environment & Understand Context
Determine the environment:
- With access to project directory and file system tools (Read, Write, Edit, Glob, Grep): Claude Code environment
- With uploaded files or chat without direct project access: Claude Desktop/Web environment
Understand the writing context:
- Ask which draft or section to inventory
- In Claude Code: If not specified, search for main writing files in the project
- In Claude Desktop: Ask to share the draft text (upload file or paste text)
- Read the draft text to understand scope and content
Step 2: Assess Current State
Analyze the draft for:
- Main themes and topics already present
- Apparent objectives or ambitions
- What seems emphasized vs. underdeveloped
- Gaps or areas that seem to need attention
- The writer's apparent driving question or purpose
Step 3: Recommend Inventory Type(s)
Based on the draft's state and writing stage, recommend appropriate inventory types. Consult references/germano-framework.md for detailed descriptions of each type:
- Simple Topic/Theme Inventory: Early/exploratory drafts
- Topic Inventory with Concerns: Mid-revision when direction is emerging
- Objectives/Ambitions Inventory: Drafts with unclear direction
- Memoranda Inventory: Capturing curiosities and things not to forget
Present options to the writer explaining why each might be helpful. Always ask the writer to confirm which type(s) they want before proceeding.
Step 4: Generate the Inventory
Based on writer selection:
- Create the appropriate inventory type(s)
- Format as an unstructured list (NOT an outline - see principles in
references/germano-framework.md) - Use the writer's language and concepts where possible
- Include items that:
- Are already in the draft
- Seem to be intended but underdeveloped
- Logically connect to what's there
- The writer might want to remember
- Keep items brief, sometimes fragmentary, in the writer's thinking voice
Step 5: Provide Comparative Analysis
Show the writer:
- What's present and emphasized in the current draft
- What's mentioned but underdeveloped
- What's in the inventory but not yet in the draft
- What might be overemphasized relative to stated goals
This comparative view helps identify gaps, priorities, and where to focus revision energy.
Step 6: Save or Present the Inventory
If in Claude Code (project directory access):
- Get current date using
date +%Y-%m-%dcommand - Ask where to save inventories (suggest
inventories/orprocess/inventories/) - Create the chosen directory if it doesn't exist
- Save with descriptive filename using actual date:
YYYY-MM-DD-[draft-name]-[type]-inventory.md - Use the structure from
assets/inventory-template.md - Confirm the save location to the user
If in Claude Desktop/Web (no project directory):
- Create the inventory as a formatted markdown artifact or downloadable file
- Present it in the chat for review
- Suggest saving with filename using current date:
YYYY-MM-DD-[draft-name]-[type]-inventory.md - Use the structure from
assets/inventory-template.md - Offer to create a formatted version for download if requested
Important Reminders
- NOT a structure: Inventories are explicitly NOT outlines or structures - they're "barely a set of notes"
- Expect change: Some items will develop, others will fall away
- Writer-centered: Focus on what's important to the writer, not external expectations
- No thesis required: The writer may have no central question yet - that's fine
- Multiple iterations: Create new inventories as the draft evolves
Reference: See references/germano-framework.md for detailed principles and examples.
What This Skill Does NOT Do
- Create outlines or hierarchical structures
- Impose external organization on the writer's material
- Judge quality or make value judgments about content
- Provide comprehensive analysis (that's for other skills/tools)
- Replace the writer's own thinking process
Integration with Other Skills
This skill works alongside:
- narrative-keywords - finding significant themes
- narrative-maps - visualizing spatial relationships
- Structural analysis tools (used later in revision)
- Project-specific revision workflows
Based on William Germano's "Know What You've Got" chapter in On Revision: The Only Writing That Counts
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.

