Software architecture and UI/UX principles for building genuinely new solutions, not derivative work. Use when designing features, architecting software, brainstorming apps, reviewing designs, or during strategy discussions. Focuses on first-principles thinking, simplicity where it matters, and creating rather than commenting.
63
54%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./renaissance-architecture/skills/renaissance-architecture/SKILL.mdQuality
Discovery
67%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description has a solid structure with an explicit 'Use when...' clause and covers both what and when. However, it tries to span a very wide domain (architecture + UI/UX + strategy) without being deeply specific about concrete actions, and its philosophical language ('genuinely new solutions', 'creating rather than commenting') adds flavor but reduces precision for skill selection purposes.
Suggestions
Narrow the scope or list more concrete actions (e.g., 'design system architectures, create wireframes, evaluate tech stacks, map user flows') to improve specificity.
Add more natural trigger terms users would actually say, such as 'system design', 'wireframe', 'user flow', 'tech stack', 'prototype', 'mockup', or 'component architecture'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (software architecture, UI/UX) and some actions (designing features, architecting software, brainstorming apps, reviewing designs), but the actions are fairly broad and the description leans more toward philosophy ('first-principles thinking', 'creating rather than commenting') than concrete capabilities. | 2 / 3 |
Completeness | Clearly answers both 'what' (software architecture and UI/UX principles for building new solutions) and 'when' (explicit 'Use when...' clause listing designing features, architecting software, brainstorming apps, reviewing designs, strategy discussions). | 3 / 3 |
Trigger Term Quality | Includes some natural keywords users might say like 'designing features', 'architecting software', 'brainstorming apps', 'reviewing designs', and 'strategy discussions'. However, these are somewhat broad and miss more specific variations users might use (e.g., 'wireframe', 'system design', 'tech stack', 'user flow', 'mockup'). | 2 / 3 |
Distinctiveness Conflict Risk | The scope is quite broad—covering both software architecture AND UI/UX AND strategy discussions—which could easily overlap with more specialized skills in any of those individual areas. The philosophical framing ('first-principles thinking', 'not derivative work') adds some distinctiveness but also vagueness. | 2 / 3 |
Total | 9 / 12 Passed |
Implementation
42%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a comprehensive philosophy and set of principles for software architecture and UI/UX design, with useful decision tables and checklists. However, it suffers from being overly long and monolithic, with repeated content (threshold triggers, simplicity defaults), philosophical padding that Claude doesn't need, and no progressive disclosure through external file references. The actionability is moderate—good checklists but no executable examples or specific implementation steps.
Suggestions
Split content into separate files (e.g., FRAMEWORK_CHOICES.md, UI_UX_PRINCIPLES.md, REVIEW_CHECKLISTS.md) and make SKILL.md a concise overview with clear links to each.
Remove or drastically shorten philosophical/motivational content (medieval scholars analogy, 'What This Rejects' section) since Claude doesn't need persuasion—just instructions.
Consolidate redundant sections: threshold triggers table appears twice, and simplicity defaults are restated in multiple places.
Add concrete examples of applying the principles—e.g., a before/after architecture decision, or a sample ADR entry documenting a complexity upgrade.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is well-structured with tables and clear formatting, but it's quite long (~400 lines) and contains significant philosophical/motivational content that Claude doesn't need (medieval scholars analogy repeated, 'What This Rejects' section is largely opinion). Several sections are redundant—threshold triggers appear twice, and the simplicity defaults table is repeated in different forms. | 2 / 3 |
Actionability | The checklists for reviewing designs and generating solutions are concrete and actionable. The threshold trigger tables provide specific decision criteria. However, there's no executable code, no specific commands, and much of the content is philosophical guidance rather than concrete instructions. The framework comparison table is useful but lacks specific implementation guidance. | 2 / 3 |
Workflow Clarity | The 'When Reviewing Designs' and 'When Generating Solutions' sections provide clear checklists and sequences. However, there are no validation checkpoints or feedback loops—for example, no guidance on how to verify that an architecture decision was correct, or how to course-correct when complexity was added prematurely. | 2 / 3 |
Progressive Disclosure | This is a monolithic wall of text at ~400 lines with no references to external files. The content covers architecture principles, framework choices, cloud infrastructure, UI/UX philosophy, anti-patterns, and application checklists—all inline. Much of this could be split into separate reference files (e.g., FRAMEWORK_CHOICES.md, UI_UX_PRINCIPLES.md, CHECKLISTS.md) with the SKILL.md serving as a concise overview. | 1 / 3 |
Total | 7 / 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.
20077d3
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.