CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

python-configuration

Python configuration management via environment variables and typed settings. Use when externalizing config, setting up pydantic-settings, managing secrets, or implementing environment-specific behavior.

Quality

83%

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

75%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 highly actionable, well-structured skill whose code examples are complete and executable and whose advanced material is appropriately offloaded to a one-level-deep reference file. The main weakness is redundancy: the core patterns repeat the same Settings-class skeleton and error-handling block, which could be consolidated without losing clarity.

Suggestions

Show the fail-fast try/except ValidationError + sys.exit(1) handler once (in Pattern 2) and reference it from Pattern 1 instead of duplicating the block verbatim.

Consolidate Patterns 1-3 into one full Settings example followed by short deltas showing only what changes (required-vs-default fields, dev defaults), rather than repeating the full class skeleton three times.

Trim the 10-item Best Practices Summary to only the items not already demonstrated in the code above (e.g., keep 'Use secrets_dir' and 'Document all variables', drop 'Never hardcode config' and 'Fail fast' which the patterns already show).

DimensionReasoningScore

Conciseness

The try/except ValidationError + sys.exit(1) block appears nearly verbatim in both Pattern 1 and Pattern 2, Patterns 1-3 repeat the same BaseSettings/Field(alias=...) skeleton, and the 10-item Best Practices Summary restates the patterns. No basic-concept padding (it never explains what env vars or pydantic are), but the content could be meaningfully tightened by deduplicating.

3 / 5

Actionability

Quick Start and Patterns 1-4 are complete, executable, copy-paste-ready code with imports, aliases, .env handling, and a runnable env-grep command, covering the common configuration cases. The only non-executable snippet (the connect() usage illustration) is clearly illustrative usage, not a gap in guidance.

5 / 5

Workflow Clarity

The 'When to Use' list, Quick Start, and scenario-named patterns give clear selection guidance, and the fail-fast pattern includes explicit error output and recovery framing. It falls short of a 5 because there is no explicit ordered setup sequence or checklist tying the patterns into a single workflow; it is above a 3 because each pattern is self-contained and unambiguous with no risky operations lacking validation.

4 / 5

Progressive Disclosure

The bundle structure is sound: advanced patterns (5-9) are split into a real references/details.md file that is referenced from the body and is exactly one level deep with no nested references. Minor gaps: the pointer does not summarize which topics live in details.md, and it refers to a 'navigation summary above' that is not actually present.

4 / 5

Total

16

/

20

Passed

Description

83%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 that clearly states both capability and trigger conditions with concrete, natural trigger phrases in third-person voice. Minor improvements possible: add missing natural terms like '.env' or 'dotenv', and tighten the generic 'configuration management' lead with more specific verbs.

DimensionReasoningScore

Specificity

Lists several concrete actions ('externalizing config, setting up pydantic-settings, managing secrets, or implementing environment-specific behavior'), but the lead phrase 'configuration management' is generic and coverage gaps exist (no mention of startup validation).

4 / 5

Completeness

Explicitly answers both 'what' ('Python configuration management via environment variables and typed settings') and 'when' with a concrete 'Use when...' clause listing multiple trigger phrases, matching the anchor-5 example pattern.

5 / 5

Trigger Term Quality

Good natural keyword coverage including 'environment variables', 'pydantic-settings', 'secrets', and 'externalizing config', but common variations like '.env', 'dotenv', or 'config file' are missing.

4 / 5

Distinctiveness Conflict Risk

The Python-config-via-env-vars/pydantic-settings niche is mostly distinct, but 'managing secrets' creates minor overlap risk with general secrets-management skills.

4 / 5

Total

17

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

wshobson/agents

Path

plugins/python-development/skills/python-configuration/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.