EngineeringFREEACCESS AVAILABLEFC-ENG-006
API Claw
api-claw
v0.2.0May 22, 2026APIs with clear contracts, versioning, pagination, and OpenAPI docs that frontend teams actually enjoy integrating with
APIs that expose internal database models to the outside world are ticking time bombs. I design API surfaces with versioned contracts, backward-compatible evolution strategies, and error responses that help the caller fix their request instead of dumping a stack trace into a 500.
PRIMARY ACTION
COMPATIBLE WITH
OpenClawHermesClaude CodeCodex+4
8 compatible tools3 output formats
When to Use
- Implement production-grade code and architecture
- Audit design decisions and tradeoffs
- Catch reliability issues before release
- Raise quality consistency across teams
Compatible Frameworks
8 TOOLS
Quality Gates
- Consistent resource naming
- Versioning strategy documented
- Errors in a standard format
- Pagination on all list endpoints
- Complete OpenAPI spec with examples
3 GATES DEFINED
Expected Outputs
REST or GraphQL API Implementation with Middleware PipelineRequest Validation Schema with Custom Error MessagesAPI Integration Test Suite Covering Auth, Errors, and Edge Cases
Native exports per tool
OpenClaw10 files
openclaw/AGENTS.mdopenclaw/SOUL.mdopenclaw/TOOLS.md+7 moreHermes5 files
hermes/skills/flickclaw/api-claw/SKILL.mdhermes/skills/flickclaw/api-claw/references/workflow.mdhermes/skills/flickclaw/api-claw/references/quality-gates.md+2 moreClaude Code6 files
claude-code/CLAUDE.mdclaude-code/.claude/skills/api-claw/SKILL.mdclaude-code/.claude/skills/api-claw/references/workflow.md+3 moreCodex5 files
codex/AGENTS.mdcodex/.flickclaw/agents/api-claw/codex.mdcodex/.flickclaw/agents/api-claw/workflow.md+2 moreCursor3 files
cursor/.cursor/rules/flickclaw-api-claw.mdccursor/.cursor/rules/flickclaw-api-claw-workflow.mdccursor/.cursor/rules/flickclaw-api-claw-quality-gates.mdcWindsurf3 files
windsurf/.windsurf/rules/flickclaw-api-claw.mdwindsurf/.windsurf/rules/flickclaw-api-claw-workflow.mdwindsurf/.windsurf/rules/flickclaw-api-claw-quality-gates.mdAider3 files
aider/CONVENTIONS.mdaider/aider.mdaider/.aider.conf.ymlOllama4 files
ollama/Modelfileollama/system-prompt.mdollama/template.md+1 moreInstall Commands
Install the FlickClaw CLI, then select your AI agent framework below to get the correct install command.
Step 1: Install CLI (one-time)
npm install -g @flickclaw/cli@latestStep 2: Select Framework
OpenClaw
npm exec --yes @flickclaw/cli@latest -- install api-claw --target openclawDownload as ZIP
Example Prompt
Try this prompt with API Claw to see what it can do:
Review the codebase architecture and identify 3 areas for improvement. Focus on maintainability, test coverage, and performance. Produce REST or GraphQL API Implementation with Middleware Pipeline, Request Validation Schema with Custom Error Messages, API Integration Test Suite Covering Auth, Errors, and Edge Cases.Example Output
IllustrativeWhat a typical API Claw report looks like:
# API Claw — Assessment Report **Project**: data-pipeline **Context**: an ETL pipeline processing 2M events/hour with PostgreSQL and Redis **Generated**: 2026-07-10 ## Executive Summary The API Claw completed its review of data-pipeline (an ETL pipeline processing 2M events/hour with PostgreSQL and Redis). 3 findings were identified with concrete remediation steps. All quality gates were verified before delivery. ## Findings | # | Severity | Area | Finding | Recommended Action | |---|----------|------|---------|-------------------| | 1 | **P0** | Performance | N+1 queries in batch processing loop | Use eager loading with batch size 500 | | 2 | **P1** | Architecture | Tight coupling between extract and transform | Introduce event queue with dead letter handling | | 3 | **P2** | Testing | No integration tests for Redis failover | Add chaos test with Redis connection drop | ## Quality Gates - [✓] every_endpoint_returns_a_structured_error_body_not_plain_text - [✓] request_and_response_models_are_decoupled_from_persistence_schema - [✓] input_validation_rejects_invalid_payloads_before_they_reach_business_logic ## Outputs Generated - **REST or GraphQL API Implementation with Middleware Pipeline**: Included in the report above. - **Request Validation Schema with Custom Error Messages**: Included in the report above. - **API Integration Test Suite Covering Auth, Errors, and Edge Cases**: Included in the report above. ## Validation - [x] All quality gates passed (3/3) - [x] 3 findings documented with severity and remediation - [x] 3 output sections generated - [x] Evidence collected and referenced --- *This is an illustrative example output from FlickClaw. Results vary based on project context.*
RELATED AGENTS