CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

morphir-architect

Designs AST node structures, implements IR-to-code transformations, applies functional programming patterns, and architects code generation backends for morphir-dotnet. Use when building or extending Morphir IR types, working with Classic/Modern IR conversions, implementing visitor patterns, or structuring code generation pipelines. Triggers include "Morphir architecture", "Morphir design patterns", "AST node", "IR transformation", "morphir-dotnet structure", "code generation backend".

1.07x
Quality

76%

Does it follow best practices?

Impact

100%

1.07x

1 of 3 eval scenarios. Add 2 more for a full score.

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/morphir-architect/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%Weight 40%Scale 1-5

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

The body is rich in project-specific actionability (commands, code, directory maps, decision trees) with well-sequenced playbooks, but it is heavily over budget: it re-teaches standard FP concepts, duplicates reference lists, and inlines content that belongs in separate files, while pointing at bundle files that are not actually present. It reads more as a project knowledge dump than a lean SKILL.md with progressive disclosure.

Suggestions

Move the three full playbooks (AST type design, ROP pipeline, lens implementation) into separate reference files and keep only brief when-to-use summaries plus links in SKILL.md, cutting several hundred lines from the main file.

Delete explanations of concepts Claude already knows — monad/functor/lens-law definitions and the from-scratch ROP and lens tutorials — and retain only morphir-dotnet-specific guidance (dual IR design, conversion functions, FQName system, build commands).

Consolidate the knowledge-base reference lists, which currently repeat in four sections, into a single reference section, and replace the fabricated sample review report with a short description of the output format.

Ship the referenced bundle files (scripts/, templates/, README.md) or remove/repair the links so progressive disclosure actually resolves, and fix the railway-oriented example so it runs (define `<!>`, `validateAge`, and `validateEmail`).

DimensionReasoningScore

Conciseness

The ~760-line body is noticeably verbose with several padded sections: it re-teaches FP concepts Claude already knows (defining monads, functors, lens laws, and railway-oriented programming from scratch in the playbooks), repeats the knowledge-base reference list in roughly four places (Core Competencies, project file tree, Pattern Catalog, Related Resources), and inlines a full fabricated sample review report ("Date: 2025-12-24", "ADT Types Reviewed: 42"). There is genuinely useful project-specific content (dual IR design, directory map, build commands), so it is above the severely-padded score of 1, but the volume of redundant and educational material clearly matches the "noticeably verbose" anchor.

2 / 5

Actionability

Most guidance is concrete and executable: real build commands ("./build.sh --target Test", "dotnet format", the Myriad generation command), complete lens and computation-expression code examples, script invocations, and template copy commands. It falls short of 5 because some examples are incomplete or non-runnable — the railway-oriented example uses the undefined operator `<!>` and undefined functions `validateAge`/`validateEmail`, and several items are marked as stubs or "planned"/"future" — but the gaps are minor relative to the overall executable content.

4 / 5

Workflow Clarity

The three playbooks are clearly sequenced with phases, numbered steps, prerequisite checklists, and post-workflow checklists, and the decision trees give unambiguous selection paths. It is not a 5 because validation is implicit rather than interleaved — checklists appear only before and after the workflow, with no explicit "validate before proceeding" feedback loops between phases; the operations involved (type design, pipeline construction) are not destructive or batch, so no cap applies.

4 / 5

Progressive Disclosure

Section structure and one-level-deep references to knowledge bases are clearly signaled, but large amounts of content that clearly belongs in separate files are inlined (three full playbooks with extensive code, the complete review-report output template, escalation and integration protocols), and the many referenced files — .agents/kbs/*.md, scripts/architecture-review.fsx, templates/*.md, README.md, MAINTENANCE.md, metadata.yaml — do not exist anywhere in the skill bundle (no references/, scripts/, or assets/ directories), so none of the links can be verified. This sits between the inlined-content and good-structure anchors.

3 / 5

Total

13

/

20

Passed

Description

88%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: specific third-person capabilities, an explicit Use-when clause with concrete trigger phrases, and a clearly delineated morphir-dotnet niche. The only weaknesses are jargon-heavy trigger terms lacking synonyms and a couple of generic triggers ("AST node", "code generation backend") with mild overlap risk against general compiler/codegen skills.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions — "Designs AST node structures, implements IR-to-code transformations, applies functional programming patterns, and architects code generation backends" — covering the design, transformation, pattern, and backend-architecture facets of the skill's domain comprehensively. It matches the anchor for multiple specific concrete actions with comprehensive coverage; it is not score 4 because no meaningful capability area of the niche is left uncovered.

5 / 5

Completeness

It explicitly answers both questions: the "what" is the four concrete capabilities in the first sentence, and the "when" is the explicit clause "Use when building or extending Morphir IR types, working with Classic/Modern IR conversions, implementing visitor patterns, or structuring code generation pipelines" followed by concrete trigger phrases. This matches the top anchor for clearly and explicitly answering both what and when with concrete triggers.

5 / 5

Trigger Term Quality

Trigger terms are explicit and natural for the domain ("Morphir architecture", "IR transformation", "morphir-dotnet structure", plus the Use-when clause mentioning visitor patterns and Classic/Modern IR conversions), giving good keyword coverage. It falls short of a 5 because the terms are almost entirely technical jargon with no synonyms or variations (e.g., nothing like "Morphir IR", "F# IR", or file/path forms a user might naturally say), though it is clearly above the midpoint of the scale.

4 / 5

Distinctiveness Conflict Risk

The morphir-dotnet framing ("for morphir-dotnet", "Morphir IR types", "morphir-dotnet structure") carves out a clear niche with mostly distinct triggers. It is not a 5 because a few triggers — "AST node", "code generation backend", "IR transformation" — are generic enough to also fire for general compiler- or codegen-design skills, creating minor overlap risk with closely related skills.

4 / 5

Total

18

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (768 lines); consider splitting into references/ and linking

Warning

relative_links

Relative link issues: 3 missing, 20 suspicious

Warning

Total

14

/

16

Passed

Repository

finos/morphir-dotnet

Path

.claude/skills/morphir-architect/SKILL.md

Reviewed

Table of Contents

Is this your skill?

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.