Skip to content

botkitsdev/botkits / skills/seo/botkits-markdown-twin

botkits-markdown-twin

Unverified

Use this when adding a clean markdown twin for one HTML page: a .md copy at the same path, a rel=alternate type=text/markdown link, and one line for it in /llms.txt.

Markdown twin

For one HTML page, publish a clean markdown copy that an agent can read instead of scraping the rendered page. The twin must carry the same facts as the HTML. Do not cloak.

Three steps

  1. Write a clean .md copy at the same path as the page, using one of the forms from the llms.txt v2 spec: append .md (page.html.md) or replace the extension (page.md). For a URL with no filename, use index.html.md or index.md.

  2. Advertise the twin from the HTML page:

    <link rel="alternate" type="text/markdown" href="/docs/install.md">
    
  3. Add one line for that twin in /llms.txt (create the file if the site does not have one yet), in the spec's file-list form: a markdown link, optionally a colon, and a short note.

Do this for the one page you were asked to cover. Do not invent a site-wide crawl, a Worker router, or content negotiation unless that work is already in scope.

Example

HTML page at /docs/install/ (or /docs/install.html). Twin at /docs/install.md (or /docs/install/index.md).

<!doctype html>
<html lang="en">
  <head>
    <link rel="alternate" type="text/markdown" href="/docs/install.md">
    <title>Install</title>
  </head>
  <body>
    <h1>Install</h1>
    <p>Run <code>npm install example</code>, then start the app with <code>npm start</code>.</p>
  </body>
</html>

/docs/install.md:

# Install

Run `npm install example`, then start the app with `npm start`.

One new line in /llms.txt:

# Example

> Product docs for agents.

## Docs

- [Install](/docs/install.md): How to install the product

The markdown has the same facts as the HTML, without navigation or other chrome. Point the llms.txt link at the twin, not the HTML page.

Inspired by

Inspired by Jeremy Howard's /llms.txt v2 proposal (clean markdown at the same URL with .md or index.md, and rel="alternate" type="text/markdown"). The spec defines the file forms, the link relation, and the /llms.txt format, but it is not a one-page recipe that does all three together. This skill adds that per-page sequence and a tiny worked example.

slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 197kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall