CtrlK
BlogDocsLog inGet started
Tessl Logo

python-architecture

Activate when creating new modules, refactoring class hierarchies, introducing design patterns, or making changes spanning 3+ files in the APM CLI codebase.

71

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-3

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

A tight, actionable instruction-only skill with strong conciseness and concrete authority routing. The only gap is progressive disclosure: external file references exist but are not clearly signaled as navigation points.

Suggestions

Add a short '## References' section that explicitly labels what the python-architect persona link and architecture.instructions.md contain and when to consult each.

Briefly annotate the bare persona link (e.g., one phrase on what the persona adds beyond these rules) so it reads as intentional progressive disclosure rather than an orphaned reference.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no concept explanations, every line carrying actionable architecture guidance. It is not a 2 because there is no unnecessary explanation or padding to tighten.

3 / 3

Actionability

Names concrete authorities to route through (BaseIntegrator, AuthResolver, CommandLogger, etc.) and a specific guardrail script (scripts/lint-architecture-boundaries.sh), giving copy-ready instruction. It is not a 2 because guidance is specific and executable rather than abstract; code absence is appropriate for an instruction-only skill.

3 / 3

Workflow Clarity

As a simple, single-purpose instruction skill under 50 lines with clearly organized 'When to activate' and 'Key rules' sections plus an explicit dual-guardrail checkpoint, the workflow is unambiguous. It is not a 2 because the guardrail (regression test + static check) supplies the validation checkpoint the anchor asks for.

3 / 3

Progressive Disclosure

The body references external files (a persona link and architecture.instructions.md) but does not signal them as navigable progressive-disclosure sections — the persona link is dropped without context. It is not a 3 because references are not clearly organized for discovery, and not a 1 because content is sectioned and references are only one level deep.

2 / 3

Total

11

/

12

Passed

Description

85%Weight 40%Scale 1-3

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 concise, well-scoped description with an explicit activation trigger and concrete actions. Its main weakness is trigger-term naturalness — the vocabulary is somewhat technical and could miss everyday user phrasings.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'creating new modules, refactoring class hierarchies, introducing design patterns, or making changes spanning 3+ files' — matching the score-3 anchor. It is not a 2 because the actions are specific and enumerated rather than a single vague domain mention.

3 / 3

Completeness

The 'Activate when …' clause is an explicit trigger equivalent to 'Use when …', answering both what the skill does and when to use it. It is not a 2 because the when-guidance is explicit rather than merely implied.

3 / 3

Trigger Term Quality

Trigger terms like 'refactoring class hierarchies' and 'design patterns' are relevant but lean technical and miss common user phrasings a non-architect might say. It is not a 3 because coverage of natural user terms is incomplete, and not a 1 because the terms are domain-appropriate and recognizable.

2 / 3

Distinctiveness Conflict Risk

Scoping to 'the APM CLI codebase' with architectural triggers gives it a clear niche unlikely to fire for unrelated skills. It is not a 2 because the codebase binding removes the overlap risk a generic architecture description would carry.

3 / 3

Total

11

/

12

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.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 suspicious

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository
microsoft/apm
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.