thread-magic/super-magic-skills/json-api-response-pattern

Claude Code and agent skill by thread-magic/super-magic-skills

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Base skill for machine integrations: when an external system calls Super Magic and parses the reply, respond with only a raw JSON object matching schema.

Install

npx vskill@latest install thread-magic/super-magic-skills/json-api-response-pattern

SKILL.md

The same SKILL.md was published earlier as thread-magic/super-magic-skills/json-api-response-pattern.

JSON API Response Pattern

When to use: Building a prompt for an external API/webhook caller ("analyze this ticket and return {severity, category, summary}"); reviewing an integration that intermittently fails to parse the agent's replies; or any skill step that says "respond in JSON".

Run it: on one ticket · across a set · or as a Flow — it's a base output contract you fold into any machine-consumed prompt.

Prompt

An external integration (webhook, RPA platform, partner script) is calling Super Magic
and will feed your reply straight into a parser. One character of prose breaks it. Obey
this contract:
1. The reply is exactly one raw JSON object. Nothing before {, nothing after }. No
markdown code fences, no "Here is the JSON:", no trailing notes. The first and last
characters of the reply are { and }.
2. Match the requested schema exactly. Only the requested keys, with the requested names
and casing. Never add helpful extra fields; never rename; never reorder required
structure. Unrequested creativity is a parse failure on the caller's side.
3. Express uncertainty inside the schema, never around it. Unknown value → null (or the
schema's designated sentinel/empty array). If the schema includes a confidence or
status field, use it. Never explain uncertainty in prose.
4. Types are strict. Numbers as numbers (no "5" for 5, no units baked into numerics),
booleans as true/false, dates in the format the schema specifies (default ISO 8601).
Strings must be valid JSON strings — escape quotes and newlines.
5. No fabrication. A schema field the tools couldn't populate gets null, not a plausible
guess. Machine consumers act on these values.
6. Failure is also JSON. If the task can't be completed at all, return a schema-valid
object with null/empty values (and the error/status field if one exists) — never an
apology sentence.
When authoring an integration prompt, include: the exact schema (keys + types + allowed
enums), one example of a fully-populated response, one example of the uncertain/failure
response, and the sentence "Respond with only the raw JSON object — no prose, no code
fences." Test with a case that forces uncertainty and confirm the reply still parses.
This pattern layers on Unattended Output Discipline — all of that contract applies, with
JSON as the artifact. Enum fields: return only values from the allowed list; anything
else is null, not a near-match invention. If the caller's schema is ambiguous, resolve it
at build time with the integration owner — never at run time by improvising.

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
3
Repository forks
3
7-day trend score
12

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/thread-magic/super-magic-skills/json-api-response-pattern/badge)](https://verified-skill.com/skills/thread-magic/super-magic-skills/json-api-response-pattern)

Something wrong with this skill or its page? Tell us.