What interface types does this skill support?

It natively supports REST_API, Event (messaging), gRPC, Database schema, File formats, and a generic 'Other' category for custom interfaces.

Can it validate my documentation format?

Yes, it integrates with the ref-documentation skill to perform AsciiDoc validation, verify cross-references, and ensure content quality.

Where are the interface documents stored?

All documentation is standardized and stored in the 'doc/interfaces/' directory using a specific sequential naming convention (e.g., 001-Title.adoc).

Does it handle automatic numbering?

Yes, the create-interface workflow automatically calculates the next available number to prevent collisions and maintain a clean chronological order.

Interface Specification Manager

Name: Interface Specification Manager
Author: cuioss

bycuioss

API 开发

Manages structured interface specifications and API documentation with automated numbering and AsciiDoc formatting.

关于

This skill provides a robust orchestration layer for Claude Code to handle technical interface documentation within the Plan Marshall framework. It automates the creation, maintenance, and validation of interface files—including REST APIs, gRPC, and event-driven contracts—within the doc/interfaces/ directory. By enforcing consistent naming conventions and template structures, it ensures that system integrations remain well-documented, searchable, and compliant with project standards through integrated validation workflows.

主要功能

CRUD operations for technical interface specifications
Pre-defined templates for REST, gRPC, Events, and Databases
0 GitHub stars
Automated sequential interface numbering and file naming
Seamless integration with reference documentation validation
AsciiDoc formatting and structure enforcement

使用场景

Standardizing documentation for database schemas and file exchange formats
Documenting new microservice REST APIs and message contracts
Maintaining a centralized registry of system-wide interface specifications

关于

主要功能

CRUD operations for technical interface specifications
Pre-defined templates for REST, gRPC, Events, and Databases
0 GitHub stars
Automated sequential interface numbering and file naming
Seamless integration with reference documentation validation
AsciiDoc formatting and structure enforcement

使用场景

Standardizing documentation for database schemas and file exchange formats
Documenting new microservice REST APIs and message contracts
Maintaining a centralized registry of system-wide interface specifications