.mdeck (1/3): the public page is discoverable to agents — SKILL.md link, /llms.txt, skills index #94

Closed
opened 2026-10-18 01:52:21 +00:00 by teahubxyz · 8 comments
Owner

Base: gh-pages

Split from #60 (its worker ran out of turns twice at the full scope). This card is the public-site part only; nothing on Whop.

Work from ventures/mdecks on gh-pages, on a branch off gh-pages, with the PR against gh-pages.

A first silicon-UX pass (an agent checking what it can find) showed the skill is invisible to an agent reading mdecks.yolopreneur.lol: its URL lives only in the button's JavaScript, and /llms.txt and /.well-known/skills/index.json return 404. Add, and nothing else on the page changes:

  • <link rel="alternate" type="text/markdown" href="/SKILL.md"> in the page head, and a plain "For agents: SKILL.md" link in the page body.
  • /llms.txt pointing at SKILL.md (a few lines: what .mdeck is, the skill's URL, the editor's URL).
  • /.well-known/skills/index.json listing the skill, mirroring the convention Whop uses for its own docs skills (docs.whop.com/.well-known/skills/index.json pointing at SKILL.md files); state that assumption in the PR.

The first run (PR #109) produced the right three files on the wrong base (main); it was closed. The content of that PR is a good reference for the next run.

DONE: PR open against gh-pages; a local check (the venture's existing check script, or python3 -m http.server plus curl in the PR body) serves /SKILL.md, /llms.txt and /.well-known/skills/index.json with 200 and the page head carries the alternate link; CI green

Base: gh-pages Split from #60 (its worker ran out of turns twice at the full scope). This card is the public-site part only; nothing on Whop. Work from `ventures/mdecks` on `gh-pages`, on a branch off `gh-pages`, with the PR against `gh-pages`. A first silicon-UX pass (an agent checking what it can find) showed the skill is invisible to an agent reading mdecks.yolopreneur.lol: its URL lives only in the button's JavaScript, and `/llms.txt` and `/.well-known/skills/index.json` return 404. Add, and nothing else on the page changes: - `<link rel="alternate" type="text/markdown" href="/SKILL.md">` in the page head, and a plain "For agents: SKILL.md" link in the page body. - `/llms.txt` pointing at SKILL.md (a few lines: what .mdeck is, the skill's URL, the editor's URL). - `/.well-known/skills/index.json` listing the skill, mirroring the convention Whop uses for its own docs skills (`docs.whop.com/.well-known/skills/index.json` pointing at SKILL.md files); state that assumption in the PR. The first run (PR #109) produced the right three files on the wrong base (`main`); it was closed. The content of that PR is a good reference for the next run. DONE: PR open against gh-pages; a local check (the venture's existing check script, or `python3 -m http.server` plus curl in the PR body) serves `/SKILL.md`, `/llms.txt` and `/.well-known/skills/index.json` with 200 and the page head carries the alternate link; CI green
teahubxyz added the ready label 2026-10-18 01:52:21 +00:00

⏱️ Time: Claude Sonnet (Anthropic) is working on this now, on branch time/card-94.

⏱️ Time: Claude Sonnet (Anthropic) is working on this now, on branch `time/card-94`. <!-- time {"beat":"dispatched","launched":true,"worker":"anthropic"} -->

⏱️ Time: sonnet opened PR #109 (16 steps, claude-sonnet-5-5). Review and landing follow on the next beat.

⏱️ Time: `sonnet` opened PR #109 (16 steps, claude-sonnet-5-5). Review and landing follow on the next beat. <!-- time {"beat":"dispatched","worker":"anthropic","pr":109,"steps":16,"seat":"sonnet","model":"claude-sonnet-5-5"} -->

⏱️ Time: today's spend is $5.01 of the $5.00 cap; carrying on tomorrow. Nothing is lost; this card resumes once there is budget.

⏱️ Time: today's spend is $5.01 of the $5.00 cap; carrying on tomorrow. Nothing is lost; this card resumes once there is budget. <!-- time {"beat":"capped"} -->
teahubxyz added queued and removed ready labels 2026-10-18 04:00:52 +00:00
teahubxyz added ready and removed queued labels 2026-10-18 05:02:57 +00:00
Author
Owner

/time retry

Fresh start on time/card-94-gh-pages, cut from gh-pages (#121 landed). PR #109 was closed because it targeted main; its three files are the right content and a good reference for this run.

/time retry Fresh start on `time/card-94-gh-pages`, cut from `gh-pages` (#121 landed). PR #109 was closed because it targeted `main`; its three files are the right content and a good reference for this run.

⏱️ Time: Claude Sonnet (Anthropic) is working on this now, on branch time/card-94-gh-pages.

⏱️ Time: Claude Sonnet (Anthropic) is working on this now, on branch `time/card-94-gh-pages`. <!-- time {"beat":"dispatched","launched":true,"worker":"anthropic"} -->

⏱️ Time: sonnet opened PR #130 (9 steps, claude-sonnet-5-5). Review and landing follow on the next beat.

⏱️ Time: `sonnet` opened PR #130 (9 steps, claude-sonnet-5-5). Review and landing follow on the next beat. <!-- time {"beat":"dispatched","worker":"anthropic","pr":130,"steps":9,"seat":"sonnet","model":"claude-sonnet-5-5"} -->

⏱️ Time: PR #130 is up for this card. haiku reviewed it on the PR.

⏱️ Time: PR #130 is up for this card. `haiku` reviewed it on the PR. <!-- time {"beat":"pr","pr":130,"launched":false,"seat":"haiku","as":"seat","review":"venice","seats":["haiku"]} -->
time closed this issue 2026-10-18 07:07:41 +00:00

⏱️ Time: approved and green, merged PR #130. Card done.

⏱️ Time: approved and green, merged PR #130. Card done. <!-- time {"beat":"merged","pr":130} -->
Sign in to join this conversation.
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: teahubxyz/time#94