agentleFS
howseen-aihowseen-ai/howseen-geo-skills/content-capsule/SKILL.md

content-capsule

Skill1 starsChanged 54 days agoMITView on GitHub

Rewrite a web page into short, answer-first "capsules" that an AI can lift verbatim into a response. Use this whenever the user wants a page to be more quotable by ChatGPT/Perplexity/Gemini, asks to make content "AI-friendly" or "answer-first", wants a TL;DR an AI will pick up, or is optimizing a blog post / product page / landing page for AI citation. Point Claude at a URL or paste the text.

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Keep the human voice: Don't flatten it into robotic Q&A — capsules read cleanly to people too.

    line 20

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

content-capsule

AI systems quote self-contained, direct passages — not long wind-ups. This skill restructures a page so its key answers sit in extractable capsules.

Why capsules work

When an AI answers a question, it pulls a passage that stands on its own and answers directly. Research on AI citation points to an optimal extractable passage of roughly 130–170 words that (a) states the answer in the first sentence, (b) is self-contained (no "as we saw above"), and (c) uses plain, declarative language. A page buried in narrative gives the model nothing clean to lift.

Steps

  1. Fetch the page (or take the pasted text). Identify the core question it answers and the 2–4 secondary questions.
  2. Write a lead capsule at the very top: a 40–60 word direct answer to the core question, first sentence = the answer, no preamble.
  3. Write a capsule per secondary question: an H2 phrased as the question, followed by a 130–170 word self-contained answer.
  4. Add a "Key facts" block: 3–6 bullet points, each a standalone factual statement (name, number, definition) an AI can quote in isolation.
  5. Keep the human voice. Don't flatten it into robotic Q&A — capsules read cleanly to people too. Answer-first is good writing, not just good GEO.

Output format

## [Core question as a heading]
[40–60 word direct answer. First sentence is the answer.]

## [Secondary question 1]
[130–170 word self-contained answer.]

## [Secondary question 2]
[130–170 word self-contained answer.]

## Key facts
- [Standalone fact]
- [Standalone fact]

Then give the user a one-line note on what changed and why (e.g. "moved the answer from paragraph 4 to sentence 1 so the model doesn't have to dig").


Built by Raphaël Aubry, founder of Howseen (https://howseen.ai). Rewriting a page is step one. Knowing whether the rewrite actually earns you citations — and holds them as models change — is what Howseen tracks. → https://howseen.ai

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.