CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

python-packaging

Comprehensive guide to creating, structuring, and distributing Python packages using modern packaging tools, pyproject.toml, and publishing to PyPI.

44

Quality

55%

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 ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/python-packaging/SKILL.md

The canonical home for this skill is python-packaging in rmyndharis/antigravity-skills

SKILL.md
Quality
Evals
Security

Quality

Content

25%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 template boilerplate: a redundant use-case list, empty exclusion filler, generic instructions that could apply to any skill, and a pointer to a playbook that is missing from the bundle. It contains essentially zero domain content for a task (packaging and publishing) that badly needs concrete pyproject.toml examples, build commands, and upload/validation steps.

Suggestions

Add concrete, executable content in SKILL.md: a minimal pyproject.toml example and the standard build/publish commands (e.g. python -m build, twine check dist/*, twine upload dist/*).

Replace the generic meta-instructions with a sequenced workflow that includes validation checkpoints — build, inspect/validate the wheel, then upload — since publishing to PyPI is effectively irreversible.

Fix the broken progressive-disclosure structure: either create resources/implementation-playbook.md with the detailed patterns it promises, or remove the dangling reference and inline the essential guidance.

DimensionReasoningScore

Conciseness

The body is short and avoids explaining concepts Claude already knows, but contains unnecessary padding: the description is repeated verbatim under the H1, and both "Do not use this skill when" bullets ("The task is unrelated to python packaging", "You need a different domain or tool outside this scope") are content-free filler. Not 4 because the filler is more than a minor instance; not 2 because the document is overall brief with no verbose concept explanations.

3 / 5

Actionability

The Instructions are entirely abstract — "Apply relevant best practices and validate outcomes", "Provide actionable steps and verification" — with no code, commands, file layouts, or tool names, describing rather than instructing. The only concrete pointer ("open resources/implementation-playbook.md") targets a file that does not exist in the bundle, so it yields no executable guidance. Not 2 because even a high-level actionable hint (naming a tool or a step of the build/publish process) is absent.

1 / 5

Workflow Clarity

There is a rough generic arc (clarify goals → apply practices → validate outcomes) but no actual sequencing of the packaging task — nothing about structuring the project, building, checking, or publishing. Publishing to PyPI is a consequential, hard-to-reverse operation, yet no validation checkpoint or feedback loop is given. Not 3 because no task steps are listed at all, only meta-instructions; not 1 because the meta-sequence is at least coherent.

2 / 5

Progressive Disclosure

Scored against the actual bundle: the body twice points to "resources/implementation-playbook.md" as the sole holder of all detail, but no resources/ directory (or any bundle file) exists, so the one-level-deep reference is dangling and no detailed content is reachable. Not 3 because the problem is not unclear signaling but a broken reference that leaves the skill with effectively no detail content; not 1 because there is no nested-reference chain or wall of text.

2 / 5

Total

8

/

20

Passed

Description

66%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 solid, specific description with good domain keywords, undermined by the complete absence of any 'use when' trigger clause, which caps completeness and slightly weakens trigger quality and distinctiveness.

Suggestions

Append an explicit trigger clause, e.g. "Use when creating or publishing a Python library, building wheels or sdists, writing pyproject.toml, or uploading to PyPI."

Add natural synonyms users actually say — "wheel", "pip", "setup.py", "package my library" — to broaden trigger coverage.

DimensionReasoningScore

Specificity

The description lists several specific actions — "creating, structuring, and distributing Python packages", "publishing to PyPI" — anchored by concrete artifacts like "pyproject.toml". Not 5 because coverage has minor gaps: wheels/sdists, entry points, and versioning go unmentioned; not 3 because it goes well beyond 1-2 actions.

4 / 5

Completeness

The 'what' is clear (create, structure, distribute Python packages, publish to PyPI), but there is no 'Use when...' clause or equivalent trigger guidance anywhere — the missing 'when' caps completeness at 3 per the judging guidelines. Not 4 because the 'when' is entirely absent rather than merely under-specified.

3 / 5

Trigger Term Quality

Strong domain keywords users would naturally say: "Python packages", "PyPI", "pyproject.toml", "publishing". Not 5 because common synonyms and artifacts are missing ("wheel", "pip", "setup.py", "library"); not 3 since it has more than 'some relevant keywords' — it includes the field's most distinctive terms.

4 / 5

Distinctiveness Conflict Risk

The packaging/PyPI/pyproject.toml niche is distinct and unlikely to fire for unrelated skills. Not 5 because adjacent skills (Python dependency management, virtualenv/uv tooling, release automation) share plausible trigger overlap given no explicit 'use when' phrasing; not 3 because the domain terms are far more specific than generic overlap-prone wording.

4 / 5

Total

15

/

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

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/python-packaging/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.