CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

python-release

Handle Python SDK release, build, bump, packaging metadata, PyPI client pin, uv.lock, nox/build workflow, and publish verification changes. Use for Python release process work or dependency pin bumps; do not use for ordinary Python feature implementation.

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/python-release/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

51%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 an extremely lean redirect: excellent progressive disclosure with a verified one-level reference, but it delegates everything — every command, step, and verification checkpoint — to the reference file, leaving the SKILL.md itself with minimal actionable or workflow guidance. A few inlined key commands and a brief step sequence would make it self-sufficient for common cases.

Suggestions

Inline the few most-used commands (e.g., `uv lock --upgrade-package composio-client`, `pip index versions composio-client`, `make build`) so the skill is actionable for common cases without opening the reference.

Add a short ordered workflow in the body (verify version resolves → update pins in pyproject.toml/setup.py → regenerate uv.lock → verify import → publish) with the verification step as an explicit checkpoint.

Remove or repurpose the 'Use this skill for Python release and packaging work.' line, which duplicates the frontmatter description without adding information.

DimensionReasoningScore

Conciseness

The body is three lean sentences with no concept explanations, matching 'efficient' — but 'Use this skill for Python release and packaging work.' restates the frontmatter description and earns no new information, a minor instance that could be trimmed. It is above 3 because there is no unnecessary explanation, and below 5 because that redundant line keeps it from 'every token earns its place'.

4 / 5

Actionability

The body's only guidance is 'Read `references/release-workflow.md` before changing Python release metadata or generated client pins' — a high-level redirect with no inline commands, code, or task steps; all executable content (make build, uv lock, pip index versions) lives in the reference. This sits between anchor 1 (not entirely vague — the pointer names an exact path and trigger conditions) and anchor 3 (no concrete task guidance is present in the body at all), so 2 fits best.

2 / 5

Workflow Clarity

The body contains no sequence, checkpoints, or validation steps for the release workflow — the ordered steps and verification commands exist only in the bundled reference file. The single-skill exception does not apply because the body itself provides no clear step sequence; it is above anchor 1 (the pointer is coherent and leads to a real workflow) but clearly below anchor 3, which requires listed steps.

2 / 5

Progressive Disclosure

The body is a clear overview pointing to one well-signaled, one-level-deep reference: `references/release-workflow.md` exists in the bundle, is referenced by exact path, and contains no further nested references. This matches the anchor for a clear overview with appropriately split content and easy navigation.

5 / 5

Total

13

/

20

Passed

Description

87%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 domain coverage, explicit use/when triggers, and a clear negative boundary that sharply reduces mis-triggering. The only improvement would be diversifying the verbs beyond 'Handle ... changes' and adding a few more natural trigger synonyms.

DimensionReasoningScore

Specificity

The description enumerates concrete, domain-specific items — 'release, build, bump, packaging metadata, PyPI client pin, uv.lock, nox/build workflow, and publish verification changes' — giving broad coverage of the release surface. It stays at 4 rather than 5 because the items are mostly artifacts/objects governed by a single generic verb ('Handle ... changes') rather than multiple distinct concrete actions like 'extract', 'fill', 'merge'.

4 / 5

Completeness

It explicitly answers both questions: what ('Handle Python SDK release, build, bump, packaging metadata, PyPI client pin, uv.lock, nox/build workflow, and publish verification changes') and when ('Use for Python release process work or dependency pin bumps'), plus a negative trigger ('do not use for ordinary Python feature implementation'). This matches the anchor for clear and explicit what-and-when with concrete trigger phrases, including an exclusion clause.

5 / 5

Trigger Term Quality

It includes natural phrases users would say such as 'Python SDK release', 'dependency pin bumps', 'PyPI', and 'uv.lock', matching how release requests are typically phrased. It falls short of 5 because common variations like 'publish', 'version bump', or 'cut a release' are only implicit, and above 3 because coverage goes well beyond one or two generic keywords.

4 / 5

Distinctiveness Conflict Risk

The niche is distinct — Python SDK release/publishing machinery (PyPI, uv.lock, nox/build) — and the explicit boundary 'do not use for ordinary Python feature implementation' prevents triggering on general Python work. Minimal conflict risk with other skills.

5 / 5

Total

18

/

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

ComposioHQ/composio

Path

.agents/skills/python-release/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.