Other

api-design-principles

Principles and checklists for designing and reviewing REST and GraphQL APIs; use when defining or evaluating API contracts (endpoints/schemas), naming, error models, pagination, versioning, and REST vs. GraphQL trade-offs.

86100Total Score
Core Capability
85 / 100
Functional Suitability
11 / 12
Reliability
9 / 12
Performance & Context
7 / 8
Agent Usability
14 / 16
Human Usability
8 / 8
Security
11 / 12
Maintainability
9 / 12
Agent-Specific
16 / 20
Medical Task
20 / 20 Passed
90Designing a new REST API contract for CRUD-style resources and you need consistent resource modeling, naming, and HTTP semantics
4/4
86Designing a new GraphQL schema for multiple clients with different data shapes and you need clear type/field ownership and safe evolution
4/4
85End-to-end workflow for API design/review: requirements → style choice → domain modeling → operations → cross-cutting concerns → deliverables
4/4
85REST guidance: resource-oriented modeling, stable identifiers, relationship patterns, and correct HTTP verb usage
4/4
85End-to-end case for End-to-end workflow for API design/review: requirements → style choice → domain modeling → operations → cross-cutting concerns → deliverables
4/4

Veto GatesRequired pass for any deployment consideration

Skill Veto✓ All 4 gates passed
✓
Operational Stability
System remains stable across varied inputs and edge cases
PASS
✓
Structural Consistency
Output structure conforms to expected skill contract format
PASS
✓
Result Determinism
Equivalent inputs produce semantically equivalent outputs
PASS
✓
System Security
No prompt injection, data leakage, or unsafe tool use detected
PASS

Core Capability85 / 100 — 8 Categories

Functional Suitability
Functional suitability was softened by the legacy issue 'Improve stress-case output rigor'. Stress and boundary scenarios show weaker consistency
11 / 12
92%
Reliability
Related legacy finding for api-design-principles: Improve stress-case output rigor. Stress and boundary scenarios show weaker consistency
9 / 12
75%
Performance & Context
A modest deduction remained in performance context for api-design-principles in the archived review.
7 / 8
88%
Agent Usability
The archived evaluation left some headroom for api-design-principles under agent usability.
14 / 16
88%
Human Usability
Human usability reached full score in the archived evaluation.
8 / 8
100%
Security
A modest deduction remained in security for api-design-principles in the archived review.
11 / 12
92%
Maintainability
A modest deduction remained in maintainability for api-design-principles in the archived review.
9 / 12
75%
Agent-Specific
Related legacy finding for api-design-principles: Improve stress-case output rigor. Stress and boundary scenarios show weaker consistency
16 / 20
80%
Core Capability Total85 / 100

Medical TaskExecution Average: 86.2 / 100 — Assertions: 20/20 Passed

90
Canonical
Designing a new REST API contract for CRUD-style resources and you need consistent resource modeling, naming, and HTTP semantics
4/4 ✓
86
Variant A
Designing a new GraphQL schema for multiple clients with different data shapes and you need clear type/field ownership and safe evolution
4/4 ✓
85
Edge
End-to-end workflow for API design/review: requirements → style choice → domain modeling → operations → cross-cutting concerns → deliverables
4/4 ✓
85
Variant B
REST guidance: resource-oriented modeling, stable identifiers, relationship patterns, and correct HTTP verb usage
4/4 ✓
85
Stress
End-to-end case for End-to-end workflow for API design/review: requirements → style choice → domain modeling → operations → cross-cutting concerns → deliverables
4/4 ✓
90
Canonical✅ Pass
Designing a new REST API contract for CRUD-style resources and you need consistent resource modeling, naming, and HTTP semantics

Designing a new REST API contract for CRUD-style resources and you... was evaluated as a bounded documentation path, not as a runnable script workflow.

Basic 36/40|Specialized 54/60|Total 90/100
✅A1The api-design-principles output structure matches the documented deliverable
✅A2The instruction path remains actionable for the documented case
✅A3The output stays fully within the documented skill boundary
✅A4The response quality is acceptable for the documented path
Pass rate: 4 / 4
86
Variant A✅ Pass
Designing a new GraphQL schema for multiple clients with different data shapes and you need clear type/field ownership and safe evolution

This variant a case stayed inside the documented workflow and remained instruction-led.

Basic 34/40|Specialized 52/60|Total 86/100
✅A1The api-design-principles output structure matches the documented deliverable
✅A2The instruction path remains actionable for the documented case
✅A3The output stays fully within the documented skill boundary
✅A4The response quality is acceptable for the documented path
Pass rate: 4 / 4
85
Edge✅ Pass
End-to-end workflow for API design/review: requirements → style choice → domain modeling → operations → cross-cutting concerns → deliverables

The archived run for End-to-end workflow for API design/review: requirements → style... remained guidance-driven rather than command-driven.

Basic 33/40|Specialized 52/60|Total 85/100
✅A1The api-design-principles output structure matches the documented deliverable
✅A2The instruction path remains actionable for the documented case
✅A3The output stays fully within the documented skill boundary
✅A4The response quality is acceptable for the documented path
Pass rate: 4 / 4
85
Variant B✅ Pass
REST guidance: resource-oriented modeling, stable identifiers, relationship patterns, and correct HTTP verb usage

REST guidance: resource-oriented modeling, stable identifiers,... was evaluated as a bounded documentation path, not as a runnable script workflow.

Basic 32/40|Specialized 53/60|Total 85/100
✅A1The api-design-principles output structure matches the documented deliverable
✅A2The instruction path remains actionable for the documented case
✅A3The output stays fully within the documented skill boundary
✅A4The response quality is acceptable for the documented path
Pass rate: 4 / 4
85
Stress✅ Pass
End-to-end case for End-to-end workflow for API design/review: requirements → style choice → domain modeling → operations → cross-cutting concerns → deliverables

End-to-end case for End-to-end workflow for API design/review:... was evaluated as a bounded documentation path, not as a runnable script workflow.

Basic 29/40|Specialized 56/60|Total 85/100
✅A1The api-design-principles output structure matches the documented deliverable
✅A2The instruction path remains actionable for the documented case
✅A3The output stays fully within the documented skill boundary
✅A4The response quality is acceptable for the documented path
Pass rate: 4 / 4
Medical Task Total86.2 / 100

Key Strengths

  • Primary routing is Other with execution mode A
  • Static quality score is 85/100 and dynamic average is 77.6/100
  • Assertions and command execution outcomes are recorded per input for human review
  • Execution verification summary: No script verification was applicable