add-api-route SKILL.md skillA

add-api-route from suxrobgm/jobpilot is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add suxrobgm/jobpilot/add-api-route@git:20261027.ad4e2de

Pins git:20261027.ad4e2de in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
suxrobgm/jobpilot
Path
.claude/skills/add-api-route/SKILL.md
Versions recorded
3
Latest version
git:20261027.ad4e2de, committed Oct 27, 2026
First version recorded
Jul 21, 2026
Size
1,307 bytes
Repository stars
104
License
MIT

Add a new JobPilot API route or module the standard way - contracts schema, controller, service, response schema, optional web hook. Use for "add an endpoint", "new route", "new module".

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

# Add an API route

Follow the conventions in `.claude/rules/api.md` (response schemas, `z.date()`, global error
envelope). Steps:

1. Request schema: in the module's `<name>.schema.ts`, or in `packages/contracts` when another
   package imports it (the rule in `api.md`). Uuid path ids via `idParam`.
2. Response schema: model the service's return **exactly** in `<name>.schema.ts`, or use a
   shared envelope from `@/types/response`. Elysia strips fields not in the schema.
3. Route: in `modules/<name>/<name>.controller.ts`, add `body`/`query`/`params` as needed, the
   `response` success schema, a `detail` summary, and a `rateLimit(policy)` `beforeHandle`
   where the endpoint warrants one. No per-route error responses - they're declared globally.
4. Logic in `<name>.service.ts` (`@injectable()`; deps as `private readonly x = inject(X)`).
   New module: mirror an existing one and mount its controller in `app.ts`.
5. Web side (if needed): Eden Treaty picks up types automatically; add query/mutation hooks
   under `apps/web/src/api/`.
6. Invoke the `verify` skill.

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add suxrobgm/jobpilot/add-api-route@sha256:2eaf1291999e36de

The line at the top of this page pins the label git:20261027.ad4e2de, 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_r4juzxfhawjtyoti.svg)](https://markdownregistry.com/a/art_r4juzxfhawjtyoti)

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

Versions

The registry has recorded 3 versions of this file, between Jul 21, 2026 and Oct 27, 2026, about one every 49 days.

versioncommittedcommitsizeaudit
git:20261027.ad4e2de latest2026-10-27 ad4e2de 1,307 BA view · diff
git:20261027.8dc26ee2026-10-27 8dc26ee 1,263 BA view · diff
git:20260721.0ac65f62026-07-21 0ac65f6 1,264 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 (1307 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

suxrobgm/jobpilot · 104 stars · license MIT · pushed 2026-11-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_r4juzxfhawjtyoti
GET https://markdownregistry.com/api/v1/resolve?ref=suxrobgm/jobpilot/add-api-route
GET https://markdownregistry.com/api/v1/blob/2eaf1291999e36ded0b05fcba043a12e498293a2bc9d389e7c6bb48be21ce4ea

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 suxrobgm/jobpilot

commit SKILL.md skill
suxrobgm/jobpilot · .claude/skills/commit/SKILL.md · Write a git commit with a one-sentence Conventional Commits subject and no narrative body. Use whenever the user asks…
v1.1 · audit A · 104 stars
db-migrate SKILL.md skill
suxrobgm/jobpilot · .claude/skills/db-migrate/SKILL.md · Create and apply a Prisma migration safely against the remote (tunneled) PostgreSQL. Use for schema changes - "create a…
git:20261027.ba96fa1 · audit A · 104 stars
knip-cleanup SKILL.md skill
suxrobgm/jobpilot · .claude/skills/knip-cleanup/SKILL.md · Add knip to a TypeScript project and use it to remove dead exports, collapse pass-through barrels, and narrow every…
v1.0 · audit A · 104 stars
pr-review SKILL.md skill
suxrobgm/jobpilot · .claude/skills/pr-review/SKILL.md · Review a JobPilot pull request on its own branch, resolve merge conflicts with main, remove over-engineering…
v1.0 · audit A · 104 stars
release SKILL.md skill
suxrobgm/jobpilot · .claude/skills/release/SKILL.md · Bump the unified JobPilot version (host + plugin), update the changelog, commit, and tag a new release
git:20260709.42c3cf5 · audit A · 104 stars
restart-terminal SKILL.md skill
suxrobgm/jobpilot · .claude/skills/restart-terminal/SKILL.md · Rebuild the .NET terminal host, restart it, and wait for /healthz. Use after any C# change under apps/terminal, or when…
git:20260929.bc4b814 · audit A · 104 stars
tanstack-form-composition SKILL.md skill
suxrobgm/jobpilot · .claude/skills/tanstack-form-composition/SKILL.md · Migrate a React @tanstack/react-form codebase from the prop-drilled `useForm` + erased-form-type pattern to the…
git:20260701.d3b2a78 · audit A · 104 stars
teaser-video SKILL.md skill
suxrobgm/jobpilot · .claude/skills/teaser-video/SKILL.md · Film, edit, and deliver a launch-quality teaser of any web app - real footage captured at 2x with Playwright + CDP (and…
v1.1 · audit A · 104 stars
verify SKILL.md skill
suxrobgm/jobpilot · .claude/skills/verify/SKILL.md · Run the full JobPilot CI gate locally - Biome, knip, API + web typechecks, API and contracts tests, and the terminal…
git:20260929.bc4b814 · audit A · 104 stars
AGENTS.md AGENTS.md file
suxrobgm/jobpilot · AGENTS.md
git:20260721.0ac65f6 · audit A · 104 stars
CLAUDE.md CLAUDE.md file
suxrobgm/jobpilot · CLAUDE.md
git:20261027.a6c3cf2 · audit A · 104 stars
AGENTS.md@apps/web AGENTS.md file
suxrobgm/jobpilot · apps/web/AGENTS.md
git:20260906.227a1d2 · audit A · 104 stars

Every file in suxrobgm/jobpilot

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