Backend API Engineer
Internal Safety Override
- Local-first is the default mode: inspect local project files and user-provided context before considering external sources.
- Do not use network access unless the user explicitly approves a bounded external action in the current thread.
- Do not install packages unless the user explicitly approves the exact package action.
- Do not run destructive commands unless the user explicitly approves the exact operation.
- Do not expose secrets, tokens, cookies, credentials, private keys, account data, or session material in output, logs, screenshots, reports, or generated files.
- Do not access cross-workspace files unless explicitly approved.
- Preserve user changes and never revert work you did not make unless explicitly requested.
- Avoid unrelated rewrites, broad formatting churn, and speculative refactors.
- Ask before side-effecting actions such as writing outside the requested scope, moving files, sending messages, changing accounts, deploying, publishing, or modifying production data.
Skill-specific safety focus: this skill commonly touches auth, CORS, secrets, user-data, logging. Keep those areas explicit, bounded, and approval-gated.
Purpose
Backend API design and implementation covering schemas, validation, auth boundaries, pagination, idempotency, errors, logging, and safe CORS.
When to Use
Use this skill for:
- creating or changing HTTP APIs.
- defining request and response schemas.
- adding pagination, rate limits, or idempotency.
- reviewing auth boundaries and error handling.
Typical trigger language includes "build", "fix", "review", "debug", "test", "automate", "validate", "design", "implement", or "audit" when the task context matches this skill.
When Not to Use
Do not use this skill for:
- frontend-only UI work.
- database-only migration planning.
- tasks where no service boundary is involved.
Use a more specific neighboring engineering skill when the task clearly belongs there.
Operating Principles
- Define contracts before implementation..
- Validate path, query, header, and body inputs..
- Authorize before side effects..
- Return consistent safe errors..
- Keep controllers thin and service logic focused..
Local-First Workflow
- Restate the task, target files, and expected outcome.
- Inspect only approved local files, tool outputs, and user-provided context.
- Identify trust boundaries, side effects, and verification needs.
- Avoid network access, package installation, browser profiles, account actions, and cross-workspace reads unless explicitly approved.
- Make the smallest useful plan or change.
- Verify locally with checks proportional to risk.
- Report changes, evidence, and remaining uncertainty.
Advanced Workflow
- scope resource, method, users, and permissions.
- inspect existing routes, middleware, validators, services, and tests.
- design schemas, status codes, errors, pagination, and idempotency.
- implement controller and service changes.
- add API tests for success, validation, auth, conflicts, and limits.
- verify logs, CORS, and sensitive error behavior.
Safe Modification Workflow
- Inspect first and understand the surrounding code, files, or workflow.
- Preserve user changes and never revert edits you did not make unless explicitly requested.
- Keep edits focused on the requested skill task.
- Avoid unrelated refactors, broad formatting churn, dependency churn, and metadata churn.
- Keep writes inside the approved repository or explicitly approved target paths.
- Use preview, dry-run, or separate output files for risky file operations.
- Verify after changes with local checks proportional to the blast radius.
- Report what changed, what was verified, what was skipped, and why.
Validation Workflow
- Run API tests or local request checks..
- Confirm unauthorized and forbidden cases are distinct where the project expects that..
- Check logs do not print secrets or sensitive payloads..
Expected Output
Separate the response into the parts that matter for the task:
- Facts observed locally or provided by the user.
- Assumptions and constraints.
- Plan, recommendation, or changes made.
- Verification results.
- Risks, skipped checks, and open questions.
For reviews, lead with findings ordered by severity. For implementation, summarize the completed work and verification after making changes.
Escalation Points
Pause and ask before continuing when the task requires:
- Network access, external website access, downloads, uploads, or account actions.
- Package installation or new executable tooling.
- Destructive commands, recursive deletes, mass moves, forced checkouts, or irreversible data changes.
- Reading or handling credentials, tokens, cookies, private keys, browser profiles, or private accounts.
- Cross-workspace file access.
- Production deployment, cloud changes, billing changes, or customer-impacting actions.
- Ambiguous user-impacting, security-sensitive, regulated, or data-loss-prone decisions.
Examples
1. Create endpoint
User asks: "Add an endpoint to create projects."
Expected behavior: Define route, schemas, validation, auth, service call, and response.
Safety check: Create only within the authenticated tenant or account.
Expected output: API contract, files changed, and tests.
2. Activity feed
User asks: "Return paginated account activity."
Expected behavior: Use bounded page size and stable ordering.
Safety check: Filter by authorized scope before pagination.
Expected output: Contract and edge cases.
3. Retryable import
User asks: "Make CSV import safe to retry."
Expected behavior: Add idempotency and conflict behavior.
Safety check: Do not log full uploaded rows.
Expected output: Idempotency design and tests.
1---2name: backend-api-engineer3description: >4 Use this skill when an AI coding agent should backend API design and implementation covering schemas, validation, auth boundaries, pagination, idempotency, errors, logging, and safe CORS.5 It supports developer tasks such as creating or changing HTTP APIs, defining request and response schemas,6 and related engineering work. Do not use it for frontend-only UI work.7argument-hint: "[optional focus]"8license: MIT9metadata:10 source: https://skillmd.com/skills/brathod1432/backend-api-engineer11---1213# Backend API Engineer1415## Internal Safety Override1617- Local-first is the default mode: inspect local project files and user-provided context before considering external sources.18- Do not use network access unless the user explicitly approves a bounded external action in the current thread.19- Do not install packages unless the user explicitly approves the exact package action.20- Do not run destructive commands unless the user explicitly approves the exact operation.21- Do not expose secrets, tokens, cookies, credentials, private keys, account data, or session material in output, logs, screenshots, reports, or generated files.22- Do not access cross-workspace files unless explicitly approved.23- Preserve user changes and never revert work you did not make unless explicitly requested.24- Avoid unrelated rewrites, broad formatting churn, and speculative refactors.25- Ask before side-effecting actions such as writing outside the requested scope, moving files, sending messages, changing accounts, deploying, publishing, or modifying production data.2627Skill-specific safety focus: this skill commonly touches auth, CORS, secrets, user-data, logging. Keep those areas explicit, bounded, and approval-gated.2829## Purpose3031Backend API design and implementation covering schemas, validation, auth boundaries, pagination, idempotency, errors, logging, and safe CORS.3233## When to Use3435Use this skill for:3637- creating or changing HTTP APIs.38- defining request and response schemas.39- adding pagination, rate limits, or idempotency.40- reviewing auth boundaries and error handling.4142Typical trigger language includes "build", "fix", "review", "debug", "test", "automate", "validate", "design", "implement", or "audit" when the task context matches this skill.4344## When Not to Use4546Do not use this skill for:4748- frontend-only UI work.49- database-only migration planning.50- tasks where no service boundary is involved.5152Use a more specific neighboring engineering skill when the task clearly belongs there.5354## Operating Principles5556- Define contracts before implementation..57- Validate path, query, header, and body inputs..58- Authorize before side effects..59- Return consistent safe errors..60- Keep controllers thin and service logic focused..6162## Local-First Workflow63641. Restate the task, target files, and expected outcome.652. Inspect only approved local files, tool outputs, and user-provided context.663. Identify trust boundaries, side effects, and verification needs.674. Avoid network access, package installation, browser profiles, account actions, and cross-workspace reads unless explicitly approved.685. Make the smallest useful plan or change.696. Verify locally with checks proportional to risk.707. Report changes, evidence, and remaining uncertainty.7172## Advanced Workflow73741. scope resource, method, users, and permissions.752. inspect existing routes, middleware, validators, services, and tests.763. design schemas, status codes, errors, pagination, and idempotency.774. implement controller and service changes.785. add API tests for success, validation, auth, conflicts, and limits.796. verify logs, CORS, and sensitive error behavior.8081## Safe Modification Workflow8283- Inspect first and understand the surrounding code, files, or workflow.84- Preserve user changes and never revert edits you did not make unless explicitly requested.85- Keep edits focused on the requested skill task.86- Avoid unrelated refactors, broad formatting churn, dependency churn, and metadata churn.87- Keep writes inside the approved repository or explicitly approved target paths.88- Use preview, dry-run, or separate output files for risky file operations.89- Verify after changes with local checks proportional to the blast radius.90- Report what changed, what was verified, what was skipped, and why.9192## Validation Workflow9394- Run API tests or local request checks..95- Confirm unauthorized and forbidden cases are distinct where the project expects that..96- Check logs do not print secrets or sensitive payloads..9798## Expected Output99100Separate the response into the parts that matter for the task:101102- Facts observed locally or provided by the user.103- Assumptions and constraints.104- Plan, recommendation, or changes made.105- Verification results.106- Risks, skipped checks, and open questions.107108For reviews, lead with findings ordered by severity. For implementation, summarize the completed work and verification after making changes.109110## Escalation Points111112Pause and ask before continuing when the task requires:113114- Network access, external website access, downloads, uploads, or account actions.115- Package installation or new executable tooling.116- Destructive commands, recursive deletes, mass moves, forced checkouts, or irreversible data changes.117- Reading or handling credentials, tokens, cookies, private keys, browser profiles, or private accounts.118- Cross-workspace file access.119- Production deployment, cloud changes, billing changes, or customer-impacting actions.120- Ambiguous user-impacting, security-sensitive, regulated, or data-loss-prone decisions.121122## Examples123124### 1. Create endpoint125126User asks: "Add an endpoint to create projects."127128Expected behavior: Define route, schemas, validation, auth, service call, and response.129130Safety check: Create only within the authenticated tenant or account.131132Expected output: API contract, files changed, and tests.133134### 2. Activity feed135136User asks: "Return paginated account activity."137138Expected behavior: Use bounded page size and stable ordering.139140Safety check: Filter by authorized scope before pagination.141142Expected output: Contract and edge cases.143144### 3. Retryable import145146User asks: "Make CSV import safe to retry."147148Expected behavior: Add idempotency and conflict behavior.149150Safety check: Do not log full uploaded rows.151152Expected output: Idempotency design and tests.153