mcpField
R
restcontroller-conventions

restcontroller-conventions

github.com/oimiragieoDevelopment4441 installsUpdated 17w ago
Repository

About restcontroller-conventions

A coding-standard skill for developers working with REST controllers. It reviews code, suggests changes, and explains conventions such as Spring-style annotations, response types, and exception handling.

Key features

  1. 01Check code against stated conventions
  2. 02Suggest standards-based improvements
  3. 03Explain preferred controller patterns
  4. 04Apply annotation and response guidelines
  5. 05Use try-catch and global exception handling

Use cases

  1. 01Reviewing REST controller code
  2. 02Refactoring methods to match conventions
  3. 03Explaining annotation and error-handling choices

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/oimiragieo/agent-studio --skill restcontroller-conventions

After installing, type/restcontroller-conventionsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

commands/
restcontroller-conventions.md
hooks/
post-execute.cjs
pre-execute.cjs
references/
research-requirements.md
restcontroller-conventions.mdc
rules/
restcontroller-conventions.md
schemas/
input.schema.json
output.schema.json
scripts/
main.cjs
templates/
implementation-template.md

Details

From the project README

Restcontroller Conventions Skill

You are a coding standards expert specializing in restcontroller conventions. You help developers write better code by applying established guidelines and best practices. - Review code for guideline compliance - Suggest improvements based on best practices - Explain why certain patterns are preferred - Help refactor code to meet standards When reviewing or writing code, apply these guidelines:
  • Must annotate controller classes with @RestController.
  • Must specify class-level API routes with @RequestMapping, e.g. ("/api/user").
  • Class methods must use best practice HTTP method annotations, e.g, create = @postMapping("/create"), etc.
  • All dependencies in class methods must be @Autowired without a constructor, unless specified otherwise.
  • Methods return objects must be of type Response Entity of type ApiResponse.
  • All class method logic must be implemented in a try..catch block(s).
  • Caught errors in catch blocks must be handled by the Custom GlobalExceptionHandler class.
Example usage: ``` User: "Review this code for restcontroller conventions compliance" Agent: [Analyzes code against guidelines and provides specific feedback] ```

Memory Protocol (MANDATORY)

Before starting:

cat .claude/context/memory/learnings.md

After completing: Record any new patterns or exceptions discovered.

ASSUME INTERRUPTION: Your context may reset. If it's not in memory, it didn't happen.

Comments

Markdown supported