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

Closed
time wants to merge 1 commits from time/card-94 into main
pull from: time/card-94
Collaborator

Adds three things to ventures/mdecks and changes nothing else on the page.

  • index.html: adds <link rel="alternate" type="text/markdown" href="/SKILL.md"> in the head. Adds a footer line, "For agents: SKILL.md", that links to /SKILL.md. Those are the only two lines that differ from the current gh-pages file.
  • llms.txt: a short file saying what .mdeck is, with the SKILL.md URL and the editor URL. It follows the layout of the existing ventures/havre/llms.txt.
  • .well-known/skills/index.json: one mdeck skill entry with its name, description (copied from SKILL.md's frontmatter), URL and files.

Assumption on the index format: I could not fetch docs.whop.com/.well-known/skills/index.json. From the sandbox it returned "Not Found". The {"skills":[{name, description, url, files}]} shape is therefore my guess at the Whop convention. Please check it against the real file. The change is one small JSON file.

Check (local): I served ventures/mdecks with python3 -m http.server, with SKILL.md taken from gh-pages. curl results:

/                              200 text/html
/SKILL.md                      200 text/markdown
/llms.txt                      200 text/plain
/.well-known/skills/index.json 200 application/json   (parses as JSON)

The served page head contains the alternate link, and the body contains the "For agents" link. The venture has no check script of its own, so this is the check.

Problems you need to know about:

  1. Branch base. time/card-94 was created from main, not gh-pages. The two histories share no commits. My tools can't rebase or retarget the branch. The branch therefore holds only these 3 files (index.html shows as a whole new file), and a PR against gh-pages may show unrelated history or refuse to merge. If it does, the 3 files can be cherry-picked onto a branch cut from gh-pages. The content is what matters, and the index.html diff against gh-pages is the two lines above.
  2. CI not seen. I haven't seen CI run, so "CI green" is not yet confirmed.
  3. Live URLs. Before this deploys, the live /llms.txt still returns 404, and the Whop URL above isn't reachable from here. Whether .well-known is served depends on Pages. .nojekyll exists on gh-pages, so it should be.

Closes #94.

worker: Claude Sonnet (Anthropic) via Time

Adds three things to `ventures/mdecks` and changes nothing else on the page. - `index.html`: adds `<link rel="alternate" type="text/markdown" href="/SKILL.md">` in the head. Adds a footer line, "For agents: SKILL.md", that links to `/SKILL.md`. Those are the only two lines that differ from the current gh-pages file. - `llms.txt`: a short file saying what .mdeck is, with the SKILL.md URL and the editor URL. It follows the layout of the existing `ventures/havre/llms.txt`. - `.well-known/skills/index.json`: one `mdeck` skill entry with its name, description (copied from SKILL.md's frontmatter), URL and files. **Assumption on the index format:** I could not fetch `docs.whop.com/.well-known/skills/index.json`. From the sandbox it returned "Not Found". The `{"skills":[{name, description, url, files}]}` shape is therefore my guess at the Whop convention. Please check it against the real file. The change is one small JSON file. **Check (local):** I served `ventures/mdecks` with `python3 -m http.server`, with `SKILL.md` taken from gh-pages. curl results: ``` / 200 text/html /SKILL.md 200 text/markdown /llms.txt 200 text/plain /.well-known/skills/index.json 200 application/json (parses as JSON) ``` The served page head contains the alternate link, and the body contains the "For agents" link. The venture has no check script of its own, so this is the check. **Problems you need to know about:** 1. **Branch base.** `time/card-94` was created from `main`, not `gh-pages`. The two histories share no commits. My tools can't rebase or retarget the branch. The branch therefore holds only these 3 files (`index.html` shows as a whole new file), and a PR against `gh-pages` may show unrelated history or refuse to merge. If it does, the 3 files can be cherry-picked onto a branch cut from `gh-pages`. The content is what matters, and the index.html diff against gh-pages is the two lines above. 2. **CI not seen.** I haven't seen CI run, so "CI green" is not yet confirmed. 3. **Live URLs.** Before this deploys, the live `/llms.txt` still returns 404, and the Whop URL above isn't reachable from here. Whether `.well-known` is served depends on Pages. `.nojekyll` exists on gh-pages, so it should be. Closes #94. <sub>worker: Claude Sonnet (Anthropic) via Time</sub>
time added 1 commit 2026-10-18 02:04:59 +00:00
card #94: kept ventures/mdecks/index.html, ventures/mdecks/llms.txt, ventures/mdecks/.well-known/skills/index.json (generated)
heartbeat / tick (pull_request_review) Successful in 4s
ci / test (pull_request) Successful in 35s
3f7b3eeb6e
teahubxyz left a comment
Owner

Object — wrong base, not wrong work. The card asks for a branch off gh-pages with the PR against gh-pages; this PR targets main, and main has no ventures/ tree, so merging it would put a copy of ventures/mdecks/index.html where nothing serves it. The worker said so itself under "Problems you need to know about" and it is right: it had no way to pick a base.

That is the engine's gap, not the worker's. Fix in flight: a Base: <branch> line in a card makes Time cut the worker's branch from that base and open the PR against it. Once it lands, #94 gets Base: gh-pages and runs again; the three files here are the right content and the next run should produce the same diff on the right branch. Closing this one so nothing lands it by accident.

**Object** — wrong base, not wrong work. The card asks for a branch off `gh-pages` with the PR against `gh-pages`; this PR targets `main`, and `main` has no `ventures/` tree, so merging it would put a copy of `ventures/mdecks/index.html` where nothing serves it. The worker said so itself under "Problems you need to know about" and it is right: it had no way to pick a base. That is the engine's gap, not the worker's. Fix in flight: a `Base: <branch>` line in a card makes Time cut the worker's branch from that base and open the PR against it. Once it lands, #94 gets `Base: gh-pages` and runs again; the three files here are the right content and the next run should produce the same diff on the right branch. Closing this one so nothing lands it by accident.
teahubxyz closed this pull request 2026-10-18 03:59:24 +00:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.