workout/ddd-functional-nextjs
Enforces full DDD conventions for TypeScript/Next.js: folder structure, layer boundaries, functional patterns, and ubiquitous language.
100
100%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that clearly articulates specific capabilities (folder validation, dependency enforcement, scaffolding generation, code review), provides comprehensive trigger terms covering the full DDD vocabulary, and explicitly states when to use it. The description is well-scoped to a distinct niche (DDD + TypeScript/Next.js + functional patterns) with minimal conflict risk.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: validates folder structure against DDD layers, enforces dependency rules between layers, generates domain module scaffolding, and reviews code for bounded context violations. | 3 / 3 |
Completeness | Clearly answers both 'what' (validates folder structure, enforces dependency rules, generates scaffolding, reviews for violations) and 'when' with an explicit 'Use when...' clause listing numerous trigger scenarios. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'domain-driven design', 'project architecture', 'bounded contexts', 'layer separation', 'clean architecture', 'hexagonal architecture', 'ports and adapters', 'aggregate', 'value object', 'ubiquitous language', 'TypeScript/Next.js'. These are terms practitioners naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive niche combining DDD conventions specifically with TypeScript/Next.js and functional patterns. The specific architectural terms (bounded contexts, hexagonal architecture, ports and adapters) and concrete actions (folder structure validation, dependency rule enforcement) make it very unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an excellent skill file that efficiently encodes a comprehensive DDD architecture for TypeScript/Next.js projects. It combines concrete code examples, clear dependency rules, a well-sequenced workflow, and an actionable violations checklist — all without wasting tokens on concepts Claude already understands. The progressive disclosure to external docs is well-structured and clearly signaled.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is dense and efficient. Every section earns its place — tables for quick reference, code examples that demonstrate patterns without over-explaining, and no unnecessary preamble about what DDD is or why it matters. Claude already knows these concepts; the skill focuses on the specific conventions to enforce. | 3 / 3 |
Actionability | Provides executable TypeScript code for domain types, command handlers, and composition roots. The folder structure is fully specified with naming conventions, the dependency table is concrete and unambiguous, and the violations checklist gives specific pass/fail criteria. | 3 / 3 |
Workflow Clarity | The 11-step workflow for creating a bounded context is clearly sequenced with a final validation step (violations checklist). The violations checklist itself serves as an explicit verification checkpoint. The dependency rules table at the top provides clear constraints for every decision point. | 3 / 3 |
Progressive Disclosure | The skill provides a clear overview with well-signaled one-level-deep references to docs/PRIMITIVES.md and docs/EXAMPLES.md for full implementations. Inline content is appropriately scoped — enough to understand the pattern without bloating the main file. Internal anchor links (workflow, violations) aid navigation. | 3 / 3 |
Total | 12 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
Reviewed
Table of Contents