CtrlK
BlogDocsLog inGet started
Tessl Logo

long-form-content-frameworks

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

Quality

66%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/long-form-content-frameworks/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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'.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
rampstackco/claude-skills
Reviewed

Table of Contents

Is this your skill?

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.