rest-api-validator

rest-api-validator is a skill for Claude Code, Cursor from aborroy/aiup-alfresco. It costs 85 tokens per session (785 once invoked), scanned A, original, Apache-2.0.

A code-review check for Alfresco’s modern annotation-based REST API, which lets applications access content over HTTP. It checks that resources, actions, identifiers, and paged results follow the framework’s rules.

In plain words
What is it for?
Use it after generating Alfresco REST resources to check entity endpoints, relationship endpoints, CRUD actions, annotations, naming, and collection responses.
Why use it?
It catches incorrectly declared or undocumented API methods that the framework may not expose or map correctly. It also flags older Web Script patterns in code meant for the newer API.

Skill for Claude CodeCursor

Written for Claude Code and Cursor: shipped in a Claude Code plugin, but also installed under .cursor/.

Part of the aiup-alfresco plugin — 38 skills, 25 commands, 3 agents, 3 hooks shipped together

Good fit Use it after generating Alfresco REST resources to check entity endpoints, relationship…

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/aborroy/aiup-alfresco/rest-api-validator
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add aborroy/aiup-alfresco --skill rest-api-validator
Clone the repo
git clone --depth 1 https://github.com/aborroy/aiup-alfresco

Made for: Claude Code, Cursor.

Or install aiup-alfresco, the plugin that ships this one along with the rest of its 38 skills, 25 commands, 3 agents, 3 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for rest-api-validator

README.md
[![agentmods](https://agentmods.dev/badge/skills/aborroy/aiup-alfresco/rest-api-validator.svg)](https://agentmods.dev/skills/aborroy/aiup-alfresco/rest-api-validator)
Your own site
<a href="https://agentmods.dev/skills/aborroy/aiup-alfresco/rest-api-validator"><img src="https://agentmods.dev/badge/skills/aborroy/aiup-alfresco/rest-api-validator.svg" alt="Measured on agentmods" height="20"></a>
Per session 85 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 785 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00085 $0.00785
Opus 5 $0.00043 $0.00392
Sonnet 5 $0.00017 $0.00157
Haiku 4.5 $0.00009 $0.00078

Measured 6d ago against content hash 5a1b1456879f, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

rest-api-validator scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.cursor/skills/rest-api-validator/SKILL.md · 56 lines

How it starts

The opening of the file, as written. The whole thing — 56 lines — stays where its author put it; the contents beside it link to each section on GitHub.

REST API Validator

Validate the given Alfresco v1 Public REST API resources against these rules. This is the modern annotation-based framework (org.alfresco.rest.framework), not classic Web Scripts.

Annotation Validation

  • Every entity resource class must be annotated @EntityResource(name = "...", title = "...").
  • Every relationship resource class must be annotated @RelationshipResource(name = "...", entityResource = X.class, title = "..."), and its entityResource must reference an existing @EntityResource-annotated class in the project.
  • The name on both annotations must be plural, kebab-case (e.g. vendor-contracts, payments) and contain no verbs.

Action Method Validation

  • The resource class must implement at least one interface from org.alfresco.rest.framework.resource.actions.interfacesEntityResourceAction.Read / ReadById / Create / Update / Delete, or RelationshipResourceAction.Read / Create / Update / Delete.
  • FLAG as ERROR any public action method (readAll, readById, create, update, delete) that is missing @WebApiDescription.
    • Why it breaks: the framework only maps annotated methods. An unannotated action method is silently unreachable and the operation returns 405 Method Not Allowed.
    • Fix: add @WebApiDescription(title = "…") to every action method.
  • A readAll method must return CollectionWithPagingInfo<T>FLAG as ERROR a raw List<T> / Collection<T> return (bypasses the paging envelope).

Model POJO Validation

  • The returned/consumed model POJO must have exactly one getter annotated @UniqueId.
    • FLAG as ERROR zero @UniqueId getters (framework cannot build readById / serialise id).
    • FLAG as ERROR more than one @UniqueId getter (ambiguous identifier).
  • The POJO should be a plain JavaBean: public no-arg constructor, getters/setters, no Alfresco service fields.

Forbidden Patterns

  • FLAG as ERROR a resource class that extends DeclarativeWebScript — that is the classic framework and will not be discovered by ResourceLookupDictionary.
  • FLAG as ERROR @Autowired — use setter injection wired in webscript-context.xml.
  • WARN if @PostConstruct or @Transactional appears on a resource class.

Read the full file on GitHub · 56 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 56 lines · 85 tokens per session scan A 5a1b1456879f

Subscribe to this mod's changes

rest-api-validator is a skill published in the GitHub repository aborroy/aiup-alfresco (13 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 85 tokens to every session and 785 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

tactical-ddd

Design, refactor, analyze, and review code by applying the principles and patterns of tactical domain-driven design. Triggers on: domain modeling, aggregate design, 'entity', 'value object', 'repository', 'bounded context', 'domain event', 'domain service', code touching domain/ directories, rich domain model…

NoesisVision/nasde-toolkit · 70 tokens

review-workflow-management

This skill reviews the HTTP management endpoints (start, status, terminate, pause, resume, raise-event, purge) that an app exposes for Dapr Workflows. Use this skill when the user asks to "review workflow management", "audit workflow management API", "check workflow HTTP endpoints", or similar.

diagrid-labs/dapr-skills · 66 tokens

review-workflow-activity

This skill reviews Dapr Workflow activity implementations for idempotency, retries, error boundaries, and convention violations. Use this skill when the user asks to "review workflow activities", "check activity idempotency", "audit Dapr activities", or similar.

diagrid-labs/dapr-skills · 57 tokens

laravel-architecture-review

Review a Laravel codebase's architecture and design, not just its types. Use when asked to audit a Laravel app, find architectural smells, decide where business logic belongs (controller vs Action vs Service), whether a Repository/DDD/TDD layer is justified, or how to apply SOLID/DRY to a Laravel project. Runs the…

majdghithan/agent-skills · 188 tokens

breaking-change-detector

Use this skill to help API producers and consumers find actual or potential breaking changes — REST/OpenAPI, GraphQL, gRPC/Protobuf, or consumer-driven contracts — and apply SemVer and deprecation discipline. Trigger on "will this change break our API consumers", "how do I detect breaking changes in our OpenAPI spec"…

EmanueleMinotto/minottobot · 179 tokens

api-design-review

Invoked helper skill for higher-risk API contract decisions, usually called from /research or /write-a-prd. Use when the unresolved question is API shape, compatibility, auth, webhook design, or paradigm choice. Not a default top-level workflow step or a substitute for ordinary implementation work.

chrislacey89/skills · 62 tokens