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.
In this repository9 other files it gives its agents.
- bing-checkSkill
- buyer-questionsSkill
- citation-checkSkill
- crawler-checkSkill
- entity-coverageSkill
- faq-schemaSkill
- llms-txtSkill
- retrievabilitySkill
- schema-builderSkill
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
- Distinctive: line 20
Keep the human voice: Don't flatten it into robotic Q&A — capsules read cleanly to people too.
≈ “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
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
- Fetch the page (or take the pasted text). Identify the core question it answers and the 2–4 secondary questions.
- Write a lead capsule at the very top: a 40–60 word direct answer to the core question, first sentence = the answer, no preamble.
- Write a capsule per secondary question: an H2 phrased as the question, followed by a 130–170 word self-contained answer.
- Add a "Key facts" block: 3–6 bullet points, each a standalone factual statement (name, number, definition) an AI can quote in isolation.
- 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
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.

