Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Rest Endpoint Designer · dicklesworthstone | DecimalAI

dicklesworthstone/rest-endpoint-designer

SkillScore77Maintained

Build rest endpoint designer operations. Auto-activating skill for API Development. Triggers on: rest endpoint designer, rest endpoint designer Part of the API Development skill category. Use when working with rest endpoint designer functionality. Trigger with phrases like "rest endpoint designer", "rest designer", "rest".

by dicklesworthstone

Links this skill to your agents and keeps it current with the author’s updates.

Automatic

Coding pack

1 · One-time — install the CLI (docs ↗)

pip install decimalai

2 · Get the skill — writes .claude/skills/dicklesworthstone-rest-endpoint-designer/SKILL.md

decimalai skills pull dicklesworthstone-rest-endpoint-designer --out .claude/skills/

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/dicklesworthstone-rest-endpoint-designer/SKILL.md https://app.decimal.ai/s/dicklesworthstone-rest-endpoint-designer/SKILL.md

Raw file: /s/dicklesworthstone-rest-endpoint-designer/SKILL.md ↗ · machine-readable summary at /s/dicklesworthstone-rest-endpoint-designer.json ↗

In productionGlobal

how this skill behaves on real traffic · last 30 days

No production data for this skill yet — usage numbers appear here once agents start running it.

Anonymized aggregate across every org using this skill — proof from real production use, not a demo.

Does this skill help? · Benchmark: with vs. withoutsign in to run this on your agents

22 test cases from the publisher’s eval.yaml · each run twice on gemini-3.6-flash — with the skill injected, then without · last run 14d ago

Yes — +5% lift · at higher cost+26% tokens0% turns77% of whole cases pass with skill (17/22)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-05	✗→✓	▲ Improved	45%	0%
case-07	✗→✓	▲ Improved	23%	0%
case-10	✓→✗	▼ Worse	45%	0%
case-03	✓→✓	＝ Same ✓	23%	0%
case-04	✓→✓	＝ Same ✓	34%	0%

Showing 5 of 22 cases

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v5 — 8/17/2026

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

dicklesworthstone / pi_agent_rust

tests/ext_conformance/artifacts/plugins-community/skills/15-api-development/rest-endpoint-designer/SKILL.md

View on GitHub ↗

License MITImported 8/17/2026Version v1

Skill contents

SKILL.md

Rest Endpoint Designer

Overview

This skill provides automated assistance for rest endpoint designer tasks within the API Development domain.

When to Use

This skill activates automatically when you:

Mention "rest endpoint designer" in your request
Ask about rest endpoint designer patterns or best practices
Need help with api development skills covering rest, graphql, openapi, authentication, and api design patterns.

Instructions

Provides step-by-step guidance for rest endpoint designer
Follows industry best practices and patterns
Generates production-ready code and configurations
Validates outputs against common standards

Examples

Example: Basic Usage Request: "Help me with rest endpoint designer" Result: Provides step-by-step guidance and generates appropriate configurations

Prerequisites

Relevant development environment configured
Access to necessary tools and services
Basic understanding of api development concepts

Output

Generated configurations and code
Best practice recommendations
Validation results

Error Handling

| Error | Cause | Solution | |-------|-------|----------| | Configuration invalid | Missing required fields | Check documentation for required parameters | | Tool not found | Dependency not installed | Install required tools per prerequisites | | Permission denied | Insufficient access | Verify credentials and permissions |

Resources

Official documentation for related tools
Best practices guides
Community examples and tutorials

Related Skills

Part of the API Development skill category. Tags: api, rest, graphql, openapi, swagger

Illustrative Want to see what dicklesworthstone/rest-endpoint-designer would put in front of your model? Preview the rendered body and check its trigger phrases — no LLM call, no signup.

Latest benchmark · publisher runVerified

9/8/2026, 06:33 UTC · 22 cases

Lift

+5%

77% vs 73%

Agent turns

1.0 vs 1.0

Tokens

+26%

3,081.09 vs 2,455.73

fail → pass · 2pass → pass · 15fail → fail · 4pass → fail · 1

Per-case results (22)

Case	Status	Duration (ms)			Turns			Tokens			Tool calls
Case	Status	Without	With	Δ	Without	With	Δ	Without	With	Δ	Without	With	Δ
case-01 I need a rest endpoint designer to help me architect a complete user profile and authentication API for my web application. Please give me production-ready OpenAPI specifications, sample controller code, and actionable security best practice guidance.	fail→fail	37,510	32,879	-12%	1	1	0%	7,257	6,514	-10%	0	0	—
case-02 I am building a GET /items endpoint that returns thousands of records. Should I return all records by default or implement limit and offset? Provide the OpenAPI path definition for GET /items with query parameters.	fail→fail	16,894	18,024	+7%	1	1	0%	2,259	2,992	+32%	0	0	—
case-03 When POST /users successfully creates a new user account, my team usually returns HTTP 200 OK with the created JSON body. Is 200 OK standard, or should a different HTTP status code be used? Show the OpenAPI response object.	pass→pass	14,367	14,535	+1%	1	1	0%	1,802	2,212	+23%	0	0	—
case-04 For DELETE /orders/{id}, if the order has already been deleted or does not exist, should the API return 404 Not Found or 204 No Content? Design the endpoint specification.	pass→pass	20,714	22,951	+11%	1	1	0%	2,831	3,795	+34%	0	0	—
case-05 I want to update only the email field of a user resource at /users/{id}. My client insists on using PUT /users/{id} with just the email JSON payload. Provide the correct RESTful HTTP method and OpenAPI schema.	fail→pass	16,102	18,912	+17%	1	1	0%	2,124	3,087	+45%	0	0	—
case-06 Design the REST endpoint path hierarchy for retrieving a specific comment on a blog post. Should the URL be GET /getBlogPostComment?id=123 or a hierarchical path?	pass→pass	15,729	19,382	+23%	1	1	0%	1,993	3,042	+53%	0	0	—
case-07 When an API request fails validation (HTTP 400), my team returns a plain text string 'Invalid request'. Provide a standardized JSON error response structure suitable for production APIs.	fail→pass	16,370	16,892	+3%	1	1	0%	2,163	2,668	+23%	0	0	—
case-08 Design an endpoint response configuration that communicates rate limit boundaries to consumers who hit GET /search.	pass→pass	19,911	21,646	+9%	1	1	0%	2,562	3,836	+50%	0	0	—
case-09 Design the GET /products query parameters for sorting by price descending and filtering by category 'electronics'. Show the OpenAPI parameter definitions.	pass→pass	16,367	15,932	-3%	1	1	0%	2,080	2,282	+10%	0	0	—
case-10 I need to import 500 customers in a single HTTP call. Should I use POST /customer/createBulk or a standard REST endpoint collection structure? Provide the specification.	pass→fail	20,730	25,911	+25%	1	1	0%	3,035	4,401	+45%	0	0	—
case-11 I need to define OAuth2 Authorization Code flow security in my OpenAPI 3.0 specification for GET /admin/dashboard. Provide the exact securitySchemes definition.	pass→pass	10,935	11,983	+10%	1	1	0%	1,142	1,767	+55%	0	0	—
case-12 Provide the OpenAPI 3.0 definition for versioning a customer API where v1 and v2 coexist. Show the path structure using path-based versioning.	fail→fail	20,761	20,975	+1%	1	1	0%	3,492	3,818	+9%	0	0	—
case-13 Design the CORS response headers required when a front-end web app on https://app.example.com calls POST /api/v1/orders across origins.	pass→pass	15,489	16,370	+6%	1	1	0%	1,941	2,799	+44%	0	0	—
case-14 Provide an OpenAPI 3.0 requestBody specification for uploading a user profile avatar image via POST /users/{id}/avatar.	pass→pass	12,827	12,891	+0%	1	1	0%	1,598	1,929	+21%	0	0	—
case-15 Design the REST API interaction pattern for triggering a heavy data export job via POST /exports that takes 10 minutes to process. What HTTP status code and response body should be returned immediately?	pass→pass	17,834	19,635	+10%	1	1	0%	2,354	3,372	+43%	0	0	—
case-16 Design the API path for retrieving items inside an order belonging to a department within an organization. Is GET /organizations/{orgId}/departments/{deptId}/orders/{orderId}/items/{itemId} recommended or should subresources be flattened?	pass→pass	16,467	16,569	+1%	1	1	0%	1,982	2,316	+17%	0	0	—
case-17 Design optimistic concurrency control headers for PUT /documents/{id} to prevent lost updates when two editors modify a document simultaneously.	pass→pass	21,236	20,698	-3%	1	1	0%	3,073	3,427	+12%	0	0	—
case-18 Design an endpoint GET /reports/{id} that can return either JSON or PDF based on client preference. Show the OpenAPI responses section handling multiple media types.	pass→pass	18,351	18,942	+3%	1	1	0%	2,630	3,285	+25%	0	0	—
case-19 Combine two GraphQL subgraphs (UsersService and OrdersService) into a unified gateway schema using GraphQL Apollo Federation directive syntax.	fail→fail	15,300	15,606	+2%	1	1	0%	1,981	3,554	+79%	0	0	—
case-20 Write a PostgreSQL SQL migration script to add a nullable column 'phone_number' to the 'users' table with a partial index on non-null values.	pass→pass	6,252	11,802	+89%	1	1	0%	1,171	1,600	+37%	0	0	—
case-21 Write a Protocol Buffers proto3 file defining a UserService gRPC interface with a CreateUser streaming RPC call.	pass→pass	16,457	11,382	-31%	1	1	0%	2,078	2,401	+16%	0	0	—
case-22 I am deprecating GET /v1/legacy-users in favor of /v2/users. Show how to signal deprecation in both OpenAPI 3.0 specs and HTTP response headers.	pass→pass	12,673	11,864	-6%	1	1	0%	2,478	2,687	+8%	0	0	—

These cases were also screened by the skill’s intent / safety pass.See the Trust review ↗Reproduce this benchmark in Colab ↗

How this skill was measured

DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 22 cases were attempted. The headline lift of +5 percentage points is the difference between those two pass rates over the 22 comparable cases. 1 case got worse with the skill loaded, and it is included in that figure.

Model measured: gemini-3.6-flash
Graded by: gemini-3.6-flash
Grading method: judged
Verification: verified
Pass rate without the skill: 72.7%
Pass rate with the skill: 77.3%
Cases attempted: 22
Cases counted toward lift: 22
Cases that regressed: 1
Skill version measured: v1
Run completed: 9/8/2026, 06:33 UTC

Measured example — same prompt, with vs. without the skill · from the benchmark run · case case-05

Prompt

I want to update only the email field of a user resource at /users/{id}. My client insists on using PUT /users/{id} with just the email JSON payload. Provide the correct RESTful HTTP method and OpenAPI schema.

Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.

Show both answers

SkillScore blends 4 signals1 of 4 complete

BenchmarkPass rate WITH skill on a verified run77

Live evalNeeds ≥10 evaluated traces in 30 days

AI ratingNeeds ≥10 rated traces

AdoptionNeeds ≥10 serves across ≥2 orgs in 30 days

Efficiency · separate axis (at equal correctness)+0% turns+29% tokens

Shown for transparency; not credited unless a verified run shows no correctness regression.

Backed by 1 of 4 signals — each added signal makes the score more robust.

Verified on gemini-3.6-flash · re-tested 13 days ago

Other measured skills in the registry, with their headline benchmark lift.