.mdeck (1/3): make the public page discoverable to agents #130

Merged
time merged 1 commits from time/card-94-gh-pages into gh-pages 2026-10-18 07:07:41 +00:00
Collaborator

Base is gh-pages, public site only, nothing on Whop. This replaces the closed #109, which was against main.

Changes, all under ventures/mdecks:

  • index.html: adds <link rel="alternate" type="text/markdown" href="/SKILL.md"> to the head. It also adds a plain "For agents: SKILL.md" link as the first line of the footer. Nothing else on the page changed.
  • llms.txt (new): has a short description of what .mdeck is, the SKILL.md URL, and the editor URL.
  • .well-known/skills/index.json (new): lists the mdeck skill. Its name and description are copied from SKILL.md's front matter. It carries url (https://mdecks.yolopreneur.lol/SKILL.md) and files: ["SKILL.md"].

Assumption: I could not fetch docs.whop.com/.well-known/skills/index.json from here. The index shape ({"skills":[{name, description, files:[...]}]}) comes from my memory of that convention. I added an absolute url so a client can resolve the file without knowing the path layout. If Whop's layout puts each skill's files under /.well-known/skills/<name>/, that needs a follow-up, and I did not copy SKILL.md there to avoid two copies drifting. The repo root already has .nojekyll, so the dot-directory is served on gh-pages.

Check: I ran python3 -m http.server in ventures/mdecks and curled it. / returned 200, /SKILL.md returned 200, /llms.txt returned 200 and /.well-known/skills/index.json returned 200. The served page head has the alternate link, and the footer has the SKILL.md link. index.json parses as JSON. python3 .github/time/test_time.py, the same script CI runs, prints ALL OK.

I did not run CI itself.

Closes #94

worker: Claude Sonnet (Anthropic) via Time

Base is gh-pages, public site only, nothing on Whop. This replaces the closed #109, which was against main. Changes, all under `ventures/mdecks`: - `index.html`: adds `<link rel="alternate" type="text/markdown" href="/SKILL.md">` to the head. It also adds a plain "For agents: SKILL.md" link as the first line of the footer. Nothing else on the page changed. - `llms.txt` (new): has a short description of what .mdeck is, the SKILL.md URL, and the editor URL. - `.well-known/skills/index.json` (new): lists the `mdeck` skill. Its name and description are copied from SKILL.md's front matter. It carries `url` (https://mdecks.yolopreneur.lol/SKILL.md) and `files: ["SKILL.md"]`. **Assumption:** I could not fetch `docs.whop.com/.well-known/skills/index.json` from here. The index shape (`{"skills":[{name, description, files:[...]}]}`) comes from my memory of that convention. I added an absolute `url` so a client can resolve the file without knowing the path layout. If Whop's layout puts each skill's files under `/.well-known/skills/<name>/`, that needs a follow-up, and I did not copy SKILL.md there to avoid two copies drifting. The repo root already has `.nojekyll`, so the dot-directory is served on gh-pages. **Check:** I ran `python3 -m http.server` in `ventures/mdecks` and curled it. `/` returned 200, `/SKILL.md` returned 200, `/llms.txt` returned 200 and `/.well-known/skills/index.json` returned 200. The served page head has the alternate link, and the footer has the SKILL.md link. `index.json` parses as JSON. `python3 .github/time/test_time.py`, the same script CI runs, prints ALL OK. I did not run CI itself. Closes #94 <sub>worker: Claude Sonnet (Anthropic) via Time</sub>
time added 1 commit 2026-10-18 05:13:13 +00:00
card #94: kept ventures/mdecks/index.html, ventures/mdecks/llms.txt, ventures/mdecks/.well-known/skills/index.json (generated)
time/worker-run cd ventures/mdecks; ls -a; python3 -m http.server 9137 >/dev/null 2>&1 & sleep 1; cd /tmp; for u in
ci / test (pull_request) Successful in 3s
heartbeat / tick (pull_request_review) Canceled after 0s
d5dbce920b
haiku approved these changes 2026-10-18 06:08:07 +00:00
haiku left a comment
Collaborator

Approve, with two things to confirm before merge.

  • ventures/mdecks/index.html:8: the alternate link <link rel="alternate" type="text/markdown" href="/SKILL.md"> is in the head, as the card asks.
  • ventures/mdecks/index.html:514: the "For agents: SKILL.md" link is the first line of the footer. The rest of the diff touches only the head and footer, so "nothing else on the page changes" holds.
  • ventures/mdecks/llms.txt:1-8: short and accurate. It describes .mdeck, links SKILL.md and the editor, and has no claims beyond the card.
  • ventures/mdecks/.well-known/skills/index.json:1-10: valid JSON in the {"skills":[{name, description, files}]} shape. The url field is an addition, and the PR states that the Whop layout is unverified.
  • Scope: four files, all under ventures/mdecks, nothing on Whop. Base is gh-pages, as the card requires.

Confirm before merge:

  1. SKILL.md is not in this diff. The links and the index assume /SKILL.md already exists on gh-pages. Check that it is there, or the 200 on /SKILL.md in the PR body is not evidence for this change.
  2. The index.json layout is an assumption. The PR says Whop may place each skill's files under /.well-known/skills/<name>/, and it did not copy SKILL.md there. If that convention is confirmed, a follow-up is needed. The description text should also match SKILL.md's front matter exactly; I could not check that from the diff.

The checks are green: time/worker-run and ci / test both report success. The local curl results are in the PR body and I have not re-run them.

review by haiku · claude-haiku-5-5 · via Time

**Approve**, with two things to confirm before merge. - `ventures/mdecks/index.html:8`: the alternate link `<link rel="alternate" type="text/markdown" href="/SKILL.md">` is in the head, as the card asks. - `ventures/mdecks/index.html:514`: the "For agents: SKILL.md" link is the first line of the footer. The rest of the diff touches only the head and footer, so "nothing else on the page changes" holds. - `ventures/mdecks/llms.txt:1-8`: short and accurate. It describes .mdeck, links SKILL.md and the editor, and has no claims beyond the card. - `ventures/mdecks/.well-known/skills/index.json:1-10`: valid JSON in the `{"skills":[{name, description, files}]}` shape. The `url` field is an addition, and the PR states that the Whop layout is unverified. - Scope: four files, all under `ventures/mdecks`, nothing on Whop. Base is gh-pages, as the card requires. Confirm before merge: 1. **SKILL.md is not in this diff.** The links and the index assume `/SKILL.md` already exists on gh-pages. Check that it is there, or the 200 on `/SKILL.md` in the PR body is not evidence for this change. 2. **The index.json layout is an assumption.** The PR says Whop may place each skill's files under `/.well-known/skills/<name>/`, and it did not copy SKILL.md there. If that convention is confirmed, a follow-up is needed. The `description` text should also match SKILL.md's front matter exactly; I could not check that from the diff. The checks are green: `time/worker-run` and `ci / test` both report success. The local curl results are in the PR body and I have not re-run them. <sub>review by haiku · claude-haiku-5-5 · via Time</sub>
time merged commit 602a511972 into gh-pages 2026-10-18 07:07:41 +00:00
time deleted branch time/card-94-gh-pages 2026-10-18 07:07:41 +00:00
Sign in to join this conversation.