CtrlK
BlogDocsLog inGet started
Tessl Logo

032-architecture-adr-non-functional-requirements

Facilitates conversational discovery to create Architectural Decision Records (ADRs) for non-functional requirements using the ISO/IEC 25010:2023 quality model. Use when the user wants to document quality attributes, NFR decisions, security/performance/scalability architecture, or design systems with measurable quality criteria. This should trigger for requests such as Create ADR for Non-functional requirements; Document Non-functional requirements; Capture Non-functional requirements; Generate Non-functional requirements in an ADR; Create ADR for performance scalability or security requirements. Part of Plinth Toolkit

69

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

70%

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

The body is well-structured with a clear validated workflow and a properly signaled one-level reference, but it loses points on conciseness (duplicated trigger and constraint lists) and actionability (ADR-generation specifics are deferred to the reference rather than surfaced inline). It is a competent interactive-skill body that would benefit from de-duplication and a small inline output skeleton.

Suggestions

Remove the duplicated "When to use this skill" list (it already lives in the frontmatter description) and fold the MANDATORY/MUST bullets into the corresponding workflow steps to eliminate repeated constraint text.

Add a compact inline ADR skeleton or field list (e.g., Context, Decision, Quality Metrics, Success Criteria) so document generation does not depend entirely on opening the reference.

Consolidate the separate "Constraints" section into the workflow steps where the constraints naturally apply, keeping the body a single lean overview pointing to the reference.

DimensionReasoningScore

Conciseness

The body is lean and free of concept padding, but there is notable duplication — the "When to use this skill" list repeats triggers already in the frontmatter description, and the "Constraints" MANDATORY/MUST bullets restate constraints already embedded in the Workflow steps — so it sits at "mostly efficient but could be tightened" rather than the fully lean level-3 anchor.

2 / 3

Actionability

Guidance is concrete in places ("Use the local shell date command", a named reference path, "Pose one or two discovery questions at a time", "Validate summary with user"), but the actual ADR-generation specifics are deferred entirely to the bundled reference, leaving the SKILL.md body with directional rather than copy-paste-ready instruction, matching the level-2 anchor; it is not level 3 because no inline template or concrete output structure is given.

2 / 3

Workflow Clarity

A clear numbered sequence (steps 0–3) with explicit validation checkpoints — "Validate summary with user ... before proposing ADR generation" and "Wait for user to confirm proceed before generating the ADR" — plus a confirm-before-proceed feedback loop, matching the top anchor; it is above level 2 because checkpoints are explicit rather than merely implied.

3 / 3

Progressive Disclosure

The SKILL.md is a concise overview with a single clearly-signaled, one-level-deep reference (references/032-architecture-adr-non-functional-requirements.md, verified to exist) referenced both in Workflow step 1 and a dedicated Reference section, matching the top anchor; it is not level 2 because navigation is clear and no content is mis-placed inline.

3 / 3

Total

10

/

12

Passed

Description

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.

The description is concise yet complete: it states concrete capabilities in third person, provides explicit "Use when..." triggers with natural phrasing, and occupies a distinctive niche. It satisfies the top anchor on every dimension.

DimensionReasoningScore

Specificity

Lists multiple concrete actions in third person — "Facilitates conversational discovery to create Architectural Decision Records (ADRs)", "document quality attributes", "NFR decisions", and "security/performance/scalability architecture" — matching the highest specificity anchor; it is not level 2 because the action set is comprehensive rather than partial.

3 / 3

Completeness

Explicitly answers both what ("create Architectural Decision Records (ADRs) for non-functional requirements") and when ("Use when the user wants to document quality attributes...") with explicit triggers, matching the top anchor; it is above level 2 because the when-clause is stated rather than merely implied.

3 / 3

Trigger Term Quality

Enumerates natural phrases a user would say — "Create ADR for Non-functional requirements", "Document Non-functional requirements", "Capture Non-functional requirements", "Generate Non-functional requirements in an ADR" — giving good coverage of common variations, so it exceeds the level-2 "some relevant keywords" anchor.

3 / 3

Distinctiveness Conflict Risk

Occupies a clear niche (ADRs for NFRs via the ISO/IEC 25010:2023 quality model) with distinct triggers unlikely to fire for unrelated skills; it is not level 2 because the triggers are too specific to overlap meaningfully with sibling skills.

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
jabrena/plinth
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.