CtrlK
BlogDocsLog inGet started
Tessl Logo

evilissimo/modular-software-design

Use before implementing or refactoring software when the task requires designing module boundaries, APIs, layers, abstractions, services, repositories, adapters, or architecture. Helps coding agents reduce total system complexity by creating deep modules, hiding implementation knowledge, avoiding leakage and pass-through APIs, comparing alternative designs, documenting interfaces before coding, and critiquing existing architecture.

93

1.13x
Quality

94%

Does it follow best practices?

Impact

93%

1.13x

Average score across 5 eval scenarios

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

Quality

Content

92%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a strong, well-crafted skill that provides clear architectural design guidance without over-explaining concepts Claude already understands. The workflow is well-sequenced with explicit validation gates and feedback loops, and the content is highly actionable with concrete templates, checklists, and decision criteria. The main weakness is that the referenced bundle files are not provided, making it impossible to fully evaluate the progressive disclosure structure, though the references themselves are clearly signaled.

DimensionReasoningScore

Conciseness

The content is lean and efficient throughout. It avoids explaining basic concepts Claude already knows (like what a module or API is), instead focusing on specific decision criteria and workflow steps. Every section earns its place by providing actionable design guidance rather than background education.

3 / 3

Actionability

The skill provides highly concrete guidance: a specific design brief template with fields to fill, a numbered workflow with clear steps, 10 explicit decision-rule questions to answer before coding, and clear triggers for when to stop and revise during implementation. While it doesn't have executable code (appropriate for a design/architecture skill), the guidance is specific and directly actionable.

3 / 3

Workflow Clarity

The 8-step workflow is clearly sequenced with logical progression from goal-setting through design comparison to implementation and reporting. It includes explicit validation checkpoints ('If answers are weak, revise the design before coding') and feedback loops ('stop and revise the design if you introduce a pass-through API, leak implementation details...'). The 10-question audit serves as a design gate before proceeding.

3 / 3

Progressive Disclosure

The skill references four external files (decision-rules.md, review-checklist.md, module-design-examples.md, architecture-critique-template.md, design-brief-template.md) with clear signaling and one-level-deep navigation. However, no bundle files were provided, so we cannot verify these references exist or are well-structured. The inline design brief template is appropriately placed, but the repeated references to decision-rules.md in two separate sections could be consolidated.

2 / 3

Total

11

/

12

Passed

Description

92%

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 a strong skill description that clearly articulates both what the skill does and when to use it, with rich trigger terms covering software architecture concepts. The description uses proper third-person voice and lists concrete actions. The only minor weakness is potential overlap with general coding or refactoring skills, though the architecture-specific focus helps differentiate it.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'creating deep modules, hiding implementation knowledge, avoiding leakage and pass-through APIs, comparing alternative designs, documenting interfaces before coding, and critiquing existing architecture.' These are detailed, actionable capabilities.

3 / 3

Completeness

Clearly answers both 'what' (designing module boundaries, creating deep modules, hiding implementation knowledge, comparing designs, documenting interfaces, critiquing architecture) and 'when' ('Use before implementing or refactoring software when the task requires designing module boundaries, APIs, layers, abstractions...'). The 'Use when' clause is explicit and upfront.

3 / 3

Trigger Term Quality

Includes strong natural keywords users would say: 'module boundaries', 'APIs', 'layers', 'abstractions', 'services', 'repositories', 'adapters', 'architecture', 'refactoring', 'designing'. These cover a wide range of terms a developer would naturally use when needing architecture guidance.

3 / 3

Distinctiveness Conflict Risk

While it targets software architecture specifically, terms like 'refactoring', 'APIs', and 'coding' could overlap with general coding skills or refactoring-focused skills. The architecture/design focus is fairly distinct but 'refactoring software' is broad enough to potentially conflict with implementation-focused skills.

2 / 3

Total

11

/

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Reviewed

Table of Contents