Evaluate public API surfaces against internal guidelines and external exemplars. Triggers: API review, API design, consistency audit, API documentation, versioning, surface inventory, exemplar research Use when: reviewing API design, auditing consistency, governing documentation, researching API exemplars DO NOT use when: architecture review - use architecture-review. DO NOT use when: implementation bugs - use bug-review. Use this skill for API surface evaluation and design review.
/plugin marketplace add athola/claude-night-market/plugin install parseltongue@claude-night-marketThis skill inherits all available tools. When active, it can use any tool Claude has access to.
modules/consistency-audit.mdmodules/exemplar-research.mdmodules/surface-inventory.mdEvaluate API surfaces against guidelines and high-quality exemplars.
/api-review
api-review:surface-inventoryapi-review:exemplar-researchapi-review:consistency-auditapi-review:docs-governanceapi-review:evidence-logModule: @modules/surface-inventory.md
Detect and catalog all public APIs by language. Record stability levels, feature flags, and versioning metadata.
Quick commands:
pwd && git status -sb
rg -n "^pub" src # Rust
rg -n "^def [^_]" package # Python
Module: @modules/exemplar-research.md
Find 2+ high-quality API references per language. Document patterns for namespacing, pagination, error handling, and documentation structure.
Common exemplars: pandas, requests, tokio, net/http, Stripe API
Module: @modules/consistency-audit.md
Compare project API against exemplar patterns. Check naming, parameters, return types, error semantics, and deprecation handling.
Identify duplication, leaky abstractions, missing feature gates, and documentation gaps.
Ensure documentation includes:
Verify versioning:
Dependency: imbue:evidence-logging
Record all executed commands and findings. Summarize recommendation (Approve / Approve with actions / Block) with action items, owners, and dates.
Load modules as needed:
## API Review Report
### Summary
[Assessment of API surface]
### Surface Inventory
- Endpoints/Functions: N
- Public types: N
- Stability: [stable/beta/experimental counts]
### Exemplar Comparison
[Key patterns from exemplars and alignment analysis]
### Consistency Issues
[I1] [Issue title]
- Location: file:line
- Recommendation: [fix]
### Documentation Gaps
[Identified gaps and required additions]
### Recommendations
- Decision: Approve / Approve with actions / Block
- Action items with owners and dates
imbue:evidence-logging for reproducible command captureimbue:diff-analysis/modules/risk-assessment-framework for breaking change assessmentimbue:structured-output for consistent findingsBuild robust backtesting systems for trading strategies with proper handling of look-ahead bias, survivorship bias, and transaction costs. Use when developing trading algorithms, validating strategies, or building backtesting infrastructure.