api-route-change SKILL.md skillA

api-route-change from dosu-ai/decant is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add dosu-ai/decant/api-route-change@git:20260929.d316718

Pins git:20260929.d316718 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
dosu-ai/decant
Path
.claude/skills/api-route-change/SKILL.md
Versions recorded
1
Latest version
git:20260929.d316718, committed Sep 29, 2026
Size
1,818 bytes
Repository stars
74
License
Apache-2.0

Add, remove, or change a route served by `decant serve`, including parameters, limits, status codes, response shapes, and SSE events. Use when editing the route table in src/server/routes.ts, the path manifest in src/route-paths.ts, or anything the UI fetches through src/ui/api.ts.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Change a serve API route

AGENTS.md invariant 7: the serve routes are a documented local API. These four
move together in one change:

1. The handler and its entry in the route table (`src/server/routes.ts`), plus
   the path manifest in `src/route-paths.ts`.
2. `docs/api/openapi.yaml`, the source contract. `/api/openapi.json` is its
   runtime representation, so a missing or stale entry is a user-visible bug.
3. `docs/api/routes.md`, the prose guide (access control, archive semantics,
   SSE events).
4. Contract tests in `test/api-contract.test.ts` and `test/server-routes.test.ts`
   (which pins the route table to the OpenAPI document), plus behavior tests in
   the relevant `test/server*.test.ts` file.

## Checks before changing semantics

- Find every UI caller: grep `src/ui/` for the path (views live in
  `src/ui/views/`). A new default limit or a narrower response can silently
  truncate what a page renders.
- Keep core modules print-free: the handler shapes HTTP, while queries and
  stats stay in their modules.
- Non-loopback serving needs explicit trusted peers. Host and Origin checks are
  defense in depth, not authentication; do not weaken either.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add dosu-ai/decant/api-route-change@sha256:2e2e5f26958b63c1

The line at the top of this page pins the label git:20260929.d316718, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_3j6j3sbg6ifstjy5.svg)](https://markdownregistry.com/a/art_3j6j3sbg6ifstjy5)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Sep 29, 2026.

versioncommittedcommitsizeaudit
git:20260929.d316718 latest2026-09-29 d316718 1,818 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (1818 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

dosu-ai/decant · 74 stars · license Apache-2.0 · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_3j6j3sbg6ifstjy5
GET https://markdownregistry.com/api/v1/resolve?ref=dosu-ai/decant/api-route-change
GET https://markdownregistry.com/api/v1/blob/2e2e5f26958b63c144422ea06655948f30949c06dd84adff3332223602fa3c1b

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from dosu-ai/decant

add-source SKILL.md skill
dosu-ai/decant · .claude/skills/add-source/SKILL.md · Add or extend a Decant source parser for another coding-agent CLI's session logs. Use when adding a new tool under…
git:20261106.85b50c2 · audit A · 74 stars
contribution-triage SKILL.md skill
dosu-ai/decant · .claude/skills/contribution-triage/SKILL.md · Assess open Decant pull requests from outside contributors against CONTRIBUTING.md and draft the outcome (ready for…
git:20261105.1debd5f · audit A · 74 stars
decant-release SKILL.md skill
dosu-ai/decant · .claude/skills/decant-release/SKILL.md · Cut a Decant release (signed vX.Y.Z tag that triggers the release workflow for GitHub Releases, npm, GHCR, and the…
git:20260929.d316718 · audit A · 74 stars
schema-migration SKILL.md skill
dosu-ai/decant · .claude/skills/schema-migration/SKILL.md · Change Decant's SQLite schema (tables, columns, indexes, triggers) or force a re-derive of existing archives. Use when…
git:20260929.d316718 · audit A · 74 stars
update-model-pricing SKILL.md skill
dosu-ai/decant · .claude/skills/update-model-pricing/SKILL.md · Add or change model token rates in Decant. Use when a provider publishes new pricing, a new model needs a rate, a model…
git:20260929.d316718 · audit A · 74 stars
AGENTS.md AGENTS.md file
dosu-ai/decant · AGENTS.md
git:20261106.85b50c2 · audit A · 74 stars
CLAUDE.md CLAUDE.md file
dosu-ai/decant · CLAUDE.md
git:20260607.5966b32 · audit B · 74 stars

Every file in dosu-ai/decant

Browse by kind, by grade A, or by owner.