Patterns for individual long-form content pieces. Case studies, whitepapers, research reports, definitive guides, manifestos, ebooks, long-form tutorials. The structural disciplines that distinguish publication-quality long-form from bloggy-long padding or academic bloat. Different from pillar-content-architecture (which covers hub structure); this skill covers individual deep-dive pieces. Triggers on long-form content, case study writing, whitepaper, research report, definitive guide, ebook, manifesto, long-form tutorial, deep-dive article, anchor piece, foundational article, structural archetypes. Also triggers when a piece is over 3,000 words and the team is unsure how to structure it, when a long-form draft feels padded or saggy, or when a flagship asset needs the depth to actually earn the length.
57
66%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/long-form-content-frameworks/SKILL.mdQuality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This description excels at trigger term coverage and completeness, with explicit 'Triggers on' guidance and clear differentiation from related skills. Its main weakness is that the actual capabilities are described somewhat abstractly — 'structural disciplines' and 'structural archetypes' — rather than listing concrete actions the skill performs. The description would benefit from replacing vague capability language with specific actions.
Suggestions
Replace abstract phrases like 'structural disciplines' and 'structural archetypes' with concrete actions such as 'creates outlines, restructures drafts, applies narrative frameworks, diagnoses structural weaknesses'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (long-form content) and lists content types (case studies, whitepapers, research reports, etc.), but the actual actions/capabilities are vague — 'structural disciplines' and 'structural archetypes' don't describe concrete actions like 'create outlines', 'restructure drafts', or 'apply narrative frameworks'. | 2 / 3 |
Completeness | The description answers both 'what' (patterns for long-form content pieces, structural disciplines for publication-quality work) and 'when' with explicit triggers — including a detailed 'Triggers on' clause and situational triggers like when a draft feels padded or when a flagship asset needs depth. It also differentiates from a related skill (pillar-content-architecture). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms including 'case study writing', 'whitepaper', 'research report', 'definitive guide', 'ebook', 'long-form tutorial', 'deep-dive article', 'anchor piece', and situational triggers like 'piece is over 3,000 words' and 'draft feels padded or saggy'. These are terms users would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | The description explicitly distinguishes itself from 'pillar-content-architecture' (hub structure vs. individual pieces), focuses on a clear niche (individual long-form content structure), and provides enough specificity in content types and situations to avoid conflicts with general writing or content strategy skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
42%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill demonstrates strong editorial thinking and excellent progressive disclosure with well-organized references, but suffers significantly from verbosity—it explains editorial concepts at length that Claude already understands (what makes a good lede, what sentence rhythm variation is, what a whitepaper is). The actionability is moderate: frameworks and percentages are useful, but the absence of worked examples (e.g., a sample outline for a whitepaper using the layered-argument archetype) limits copy-paste utility. The skill would benefit greatly from being cut by 40-50% and replacing descriptive passages with concrete templates or examples.
Suggestions
Cut the skill by 40-50%: remove explanations of concepts Claude already knows (what each format is, what sentence rhythm means, what citation laundering is) and keep only the decision criteria, structural patterns, and weight calibrations that are genuinely novel guidance.
Add 2-3 worked examples: e.g., a sample whitepaper outline using the layered-argument archetype with section weights filled in, or a before/after of a saggy lede rewritten using the contested-claim pattern.
Add explicit validation checkpoints to the 12-consideration framework: e.g., 'After step 4, review section weights—if any section is 3x another bearing similar load, rebalance before drafting further.'
Consolidate the 'what this skill is for' and scope-differentiation section into 2-3 lines; the extensive comparison with 6 other skills consumes tokens without adding actionable guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~4,000+ words, with extensive explanations of concepts Claude already understands (what a case study is, what a whitepaper is, what sentence rhythm variation means). The 'what this skill is for' section spends significant tokens differentiating from other skills, and the failure modes section restates concepts already covered. Much of this content is editorial philosophy that Claude can infer rather than actionable instruction. | 1 / 3 |
Actionability | The skill provides concrete frameworks (12 considerations checklist, section weight percentages, lede patterns) that are specific enough to act on, but lacks executable examples—no sample outlines, no before/after rewrites, no template structures. The guidance is descriptive rather than demonstrative; it tells Claude what good long-form looks like but rarely shows a worked example of applying the framework to produce output. | 2 / 3 |
Workflow Clarity | The 12-consideration framework at the end provides a clear sequence for planning/auditing, and the format-decision flow is logical. However, there are no explicit validation checkpoints or feedback loops—no 'check this before proceeding' gates. For a skill involving content creation (a multi-step, iterative process), the absence of draft-review-revise cycles or explicit quality gates is a gap. | 2 / 3 |
Progressive Disclosure | The skill is well-structured with clear sections, a summary framework, and consistent references to 9 detailed reference files with descriptive annotations. Navigation is one level deep, references are clearly signaled with both links and content descriptions, and the main document serves as an effective overview that points to deeper material. | 3 / 3 |
Total | 8 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
8e70d03
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.