mcpField
P
platform-backend

platform-backend

github.com/ravnhqDevelopment1643 installsUpdated 21w ago
Repository

About platform-backend

platform-backend is a skill for backend API work. It emphasizes failing early with guard clauses, surfacing every error, and following a workflow to assess requests and validate actionable output.

Key features

  1. 01Fail early with guard clauses
  2. 02Log or propagate every error
  3. 03Check whether requests match the skill scope
  4. 04Follow a workflow to produce concrete output
  5. 05Review and refine results when needed

Use cases

  1. 01Design error handling for an API endpoint
  2. 02Plan validation for request data

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ravnhq/ai-toolkit --skill platform-backend

After installing, type/platform-backendin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
endpoint-blueprint.md
rules/
_sections.md
api-authorization-vs-authentication.md
api-output-schemas.md
api-request-lifecycle.md
api-select-sensitive-fields.md
error-domain-specific.md
error-http-codes.md
logging-structured.md
security-dont-expose-internals.md
security-dont-log-secrets.md
security-filter-by-tenant.md
security-never-commit-secrets.md
security-procedure-hierarchy.md
validation-at-boundary.md
validation-strict-schemas.md

Details

From the project README

Principles

  • Throw early with guard clauses — fail fast at the top of functions
  • Never swallow errors silently — log or propagate every failure

Rules

See rules index for detailed patterns.

Examples

Positive Trigger

User: "Design error handling and validation strategy for this API endpoint."

Expected behavior: Use platform-backend guidance, follow its workflow, and return actionable output.

Non-Trigger

User: "Create a Tailwind design token scale."

Expected behavior: Do not prioritize platform-backend; choose a more relevant skill or proceed without it.

Troubleshooting

Skill Does Not Trigger
  • Error: The skill is not selected when expected.
  • Cause: Request wording does not clearly match the description trigger conditions.
  • Solution: Rephrase with explicit domain/task keywords from the description and retry.
Guidance Conflicts With Another Skill
  • Error: Instructions from multiple skills conflict in one task.
  • Cause: Overlapping scope across loaded skills.
  • Solution: State which skill is authoritative for the current step and apply that workflow first.
Output Is Too Generic
  • Error: Result lacks concrete, actionable detail.
  • Cause: Task input omitted context, constraints, or target format.
  • Solution: Add specific constraints (environment, scope, format, success criteria) and rerun.

Workflow

  1. Identify whether the request clearly matches platform-backend scope and triggers.
  2. Apply the skill rules and referenced guidance to produce a concrete result.
  3. Validate output quality against constraints; if gaps remain, refine once with explicit assumptions.

Comments

Markdown supported