Skip to content

docs(skill): Tell agents to read any page as Markdown with the Accept header - #124

Merged
deanzaka merged 1 commit into
mainfrom
surf/1106-skill-accept-markdown
Nov 9, 2026
Merged

docs(skill): Tell agents to read any page as Markdown with the Accept header#124
deanzaka merged 1 commit into
mainfrom
surf/1106-skill-accept-markdown

Conversation

@johnxie

@johnxie johnxie commented Nov 6, 2026

Copy link
Copy Markdown
Member

Why

This file is the source of the agent skill that taskcade serves at https://www.taskade.com/SKILL.md (src/backend/concerns/mcp/agentSkillText.ts, which copies this file exactly). taskade/taskcade#33591 adds one line to the served copy. This PR adds the same line here, so the next copy keeps it.

Cloudflare Markdown for Agents is on for the taskade.com zone (setting content_converter). Any page answers an Accept: text/markdown request with Content-Type: text/markdown, for example /pricing, /apps and /learn/account/free-plan. /llms.txt stays text/plain.

Change

One bullet under "Learn more", after the llms.txt line. The text is the same as in taskade/taskcade#33591:

- Any page as Markdown: send `Accept: text/markdown` to the normal page URL, for example `curl -H 'Accept: text/markdown' https://www.taskade.com/pricing`.

Before / after (agent flow)

BEFORE  agent -> SKILL.md (no hint) -> GET /pricing -> HTML, or a guessed /pricing.md -> 404
AFTER   agent -> SKILL.md -> GET /pricing  Accept: text/markdown -> 200 text/markdown

Note: #120 (open) also edits skills/taskade/SKILL.md. Its hunks are in other sections, so the two PRs do not conflict.

Copilot AI lite review requested due to automatic review settings November 6, 2026 22:51
@changeset-bot

changeset-bot Bot commented Nov 6, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 45eca31

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@johnxie

johnxie commented Nov 6, 2026

Copy link
Copy Markdown
Member Author

@deanzaka Impact of this PR. It adds one line to the source of the agent skill, the same line that taskade/taskcade#33591 adds to the served copy.

Area Who sees it What changes Risk
skills/taskade/SKILL.md AI agents that install the Taskade skill One "Learn more" bullet: send Accept: text/markdown to any page URL to read it as Markdown None. The text is plain and matches taskcade#33591 
BEFORE  agent -> SKILL.md (no hint) -> GET /pricing -> HTML, or a guessed /pricing.md -> 404
AFTER   agent -> SKILL.md -> GET /pricing  Accept: text/markdown -> 200 text/markdown
# Step Expected
1 Open skills/taskade/SKILL.md on this branch, section "Learn more" The new bullet follows the llms.txt line
2 Compare the bullet with taskcade#33591 src/backend/concerns/mcp/agentSkillText.ts Same text
3 curl -s -D - -o /dev/null -H 'Accept: text/markdown' https://www.taskade.com/pricing | grep -i content-type text/markdown; charset=utf-8
4 After taskcade#33591 deploys: curl -s https://www.taskade.com/SKILL.md | grep 'Accept: text/markdown' 1 line

Copilot AI reviewed Nov 6, 2026
View reviewed changes

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

The review identified no active issues in the sole changed file, which clearly documents requesting normal Taskade pages as Markdown with the appropriate header.

No open issues 🎉

What changed in this PR

Updates the Taskade agent skill to explain how agents can request normal Taskade pages as Markdown using the Accept: text/markdown header.

Changes:

  • Added an “Any page as Markdown” instruction under “Learn more.”
  • Included a curl example using Accept: text/markdown.
  • Clarified that agents should use normal page URLs instead of guessing .md paths.
File Description
skills/​taskade/​SKILL.md Documents how agents can request normal Taskade page URLs as Markdown.

Review effort: Lite

@deanzaka
deanzaka merged commit 9e02f78 into main Nov 9, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot
Copilot review effort
Applies to this pull request for everyone.Learn more about Copilot code review.
Copilot left review comments

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@johnxie @deanzaka