CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

order-service

Defines coding conventions, error handling patterns, async practices, logging standards, API response formats, and testing workflows for the Order Service — a FastAPI/Python microservice. Covers typed exception classes with FastAPI exception handler registration, structlog structured logging, Pydantic request/response models, and pytest-asyncio endpoint tests. Use when writing or modifying order endpoints, implementing order processing logic, adding error handling, or working with any file matching app/**/*.py or tests/**/*.py in the Order Service.

Quality

87%

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

81%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.

A well-organized, largely copy-paste-ready skill body covering errors, async, logging, responses, and testing with an excellent validated test workflow. Its weaknesses are minor: slight redundancy in the async section, unshown fixtures/models, and no use of reference files despite moderate length.

DimensionReasoningScore

Conciseness

The body is efficient — terse rule statements and compact, purposeful code blocks with no padding or explanations of concepts Claude already knows. Minor redundancy exists (the Async Patterns section restates the await rule for external calls already covered by 'Never use synchronous blocking calls inside an endpoint'), so it is not fully lean.

4 / 5

Actionability

Guidance is mostly executable: complete code for exception classes, handler registration, raising, logging, response shape, and a concrete test-run command. Minor gaps remain — the 'client' and 'sample_order' fixtures are referenced but never shown, and no Pydantic model example appears despite the description naming them.

4 / 5

Workflow Clarity

The Test Workflow is a clearly sequenced 6-step process with an explicit feedback loop ('If failures occur — verify mock setup first (correct patch target, AsyncMock vs MagicMock), then re-run until all assertions pass'). Steps are concrete and ordered, matching the top anchor with validation and error recovery built in.

5 / 5

Progressive Disclosure

The file is well-sectioned with appropriately placed inline content and no broken or nested references (no bundle files exist). At ~150 lines, it exceeds the small-skill exception, and dense sections like the Memory Bank template or full handler code could arguably be split into reference files, so it fits 'good structure; minor organization gaps'.

4 / 5

Total

17

/

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 third-person description that clearly states what the skill covers and when to use it, with concrete, technology-specific capabilities and explicit file-scope triggers. Trigger-term coverage is good but not exhaustive of natural synonyms, and a few generic phrases create minor conflict risk with broader Python skills.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions — 'typed exception classes with FastAPI exception handler registration, structlog structured logging, Pydantic request/response models, and pytest-asyncio endpoint tests' — covering all major convention domains of the service. Coverage is comprehensive rather than leaving minor gaps, matching the top anchor.

5 / 5

Completeness

It explicitly answers both questions: the 'what' ('Defines coding conventions, error handling patterns, async practices, logging standards...') and a concrete 'Use when...' clause with specific trigger phrases and file patterns. This matches the top anchor exactly.

5 / 5

Trigger Term Quality

Natural trigger phrases like 'writing or modifying order endpoints', 'implementing order processing logic', and file globs 'app/**/*.py or tests/**/*.py' give good keyword coverage. A few natural terms users might say are missing (e.g., 'tests', 'unit tests', 'fixing bugs'), so it falls short of the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

The description is anchored to a clear niche ('the Order Service — a FastAPI/Python microservice') with file globs, making it mostly distinct. However, generic phrases like 'adding error handling' and 'logging standards' carry minor overlap risk with general Python coding-convention skills.

4 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

jbaruch/qcon-london-2026-300-tokens

Path

.claude/skills/order-service/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.