api-versioning

Implements RESTful API design with versioning and request specs. Use when building APIs, adding API endpoints, versioning APIs, or when user mentions REST, JSON API, or API design.

1.26x

Quality

77%

Does it follow best practices?

Impact

100%

1.26x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/api-versioning/SKILL.md

Evaluation results

100%

11%

Add a Products API to a Rails Application

Versioned API resource setup

Criteria

Without context

With context

URL path versioning

100%

Namespaced routes

100%

Api::BaseController file

100%

CSRF skip

50%

100%

Rescue from errors

100%

Version base controller

100%

Resource controller inheritance

100%

Pagination with per-25

100%

Pagination meta in response

100%

Data wrapper

100%

Created status

100%

No content on destroy

100%

Bang methods in mutations

100%

35%

Write Test Coverage for a Rails API

Request spec coverage

Criteria

Without context

With context

Request spec type

100%

Correct spec path

100%

Accept header

100%

Content-Type header

100%

Headers used in requests

100%

json_response helper

70%

100%

Pagination meta test

100%

404 not-found test

100%

Validation error test

50%

100%

Created status on create

100%

15%

Harden an Existing Rails API Base Controller

API base controller error handling

Criteria

Without context

With context

Skip CSRF

62%

100%

Respond to JSON

37%

100%

Rescue RecordNotFound

75%

100%

Rescue RecordInvalid

75%

100%

Rescue ParameterMissing

75%

100%

not_found uses 'error' key

100%

unprocessable uses 'errors' key

90%

100%

bad_request uses 'error' key

100%

Bearer token extraction

100%

Token user lookup

100%

Unauthorized response

100%

Repository: ThibautBaissac/rails_ai_agents
Commit: 15fdeaf

Evaluated: 30 days ago
Agent: Claude Code
Model: Claude Sonnet 4.6

Table of Contents

Add a Products API to a Rails Application Write Test Coverage for a Rails API Harden an Existing Rails API Base Controller

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.