CtrlK
BlogDocsLog inGet started
Tessl Logo

python-providers

Create, modify, test, or package Python provider adapters under python/providers, including framework-specific dependencies, public imports, type inference, and provider metadata. Use for Python provider work only; use python-sdk for core SDK changes.

69

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

86%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 clean, router-style SKILL.md that does exactly what a lean overview should: point to one verified, well-organized workflow reference and get out of the way. The only soft spot is that the body defers all substantive guidance — a single inline command or example would make it self-sufficient for the simplest case.

DimensionReasoningScore

Conciseness

The body is three lines with zero padding and no explanation of concepts Claude already knows — every sentence either frames the skill or gives the single operative instruction. This matches the 'lean and efficient; every token earns its place' anchor.

5 / 5

Actionability

The one directive is fully concrete and executable — "Read `references/provider-workflow.md` before changing `python/providers/*`" names an exact file and an exact trigger condition, and the reference (verified present) carries the executable make/pytest commands. It stops short of level 5 because the body itself is only a pointer with no inline example or command for the common case.

4 / 5

Workflow Clarity

The body gives a clear, unambiguous pre-step (read the workflow reference before any provider change) and the referenced workflow document sequences create → implement → verify with explicit verification commands (make chk / make tst / make type_inference). It is not level 5 because the multi-step provider workflow itself is not sequenced or checkpointed in the body — the body only routes to it.

4 / 5

Progressive Disclosure

The body is a clear overview routing to a single, well-signaled, one-level-deep reference ("references/provider-workflow.md", verified to exist and to contain the workflow detail), and the detailed content is appropriately split out of SKILL.md. This matches the level-5 anchor for clear overview with one-level-deep, well-signaled references.

5 / 5

Total

18

/

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: concrete, action-verb-driven, path-scoped, in third person, and explicitly disambiguated from the sibling python-sdk skill. The main weakness is the trigger side — the 'Use for' clause is circular and natural-language synonyms for provider work are missing.

Suggestions

Replace the circular trigger "Use for Python provider work only" with concrete situations, e.g., "Use when adding, updating, testing, or packaging a Python provider adapter, or when touching provider metadata, dependency declarations, or type-inference wiring."

Add natural trigger variations users would actually say, such as "add a new provider", "provider integration", or "provider package", to widen trigger-term coverage.

DimensionReasoningScore

Specificity

Four concrete actions are named ("Create, modify, test, or package Python provider adapters") and anchored to a concrete location ("under python/providers"), with covered concerns enumerated ("framework-specific dependencies, public imports, type inference, and provider metadata"). This matches the anchor for multiple specific concrete actions with comprehensive coverage, not the level-4 anchor with minor gaps.

5 / 5

Completeness

Both 'what' (create/modify/test/package provider adapters with named sub-concerns) and 'when' ("Use for Python provider work only") are explicitly present. It does not reach level 5 because the 'when' clause is circular — it restates the 'what' ("Python provider work") rather than giving concrete trigger phrases a user would say.

4 / 5

Trigger Term Quality

Good natural keywords for the domain ("Python provider", "provider adapters", "python/providers") that a user of this codebase would plausibly say. It falls short of level 5 because no synonyms or variations are covered (e.g., "add a new provider", "provider integration", "provider wrapper"), and above level 3 because the terms present are specific and natural rather than generic.

4 / 5

Distinctiveness Conflict Risk

The skill is scoped to a concrete path ("python/providers") and explicitly disambiguates the nearest neighbor ("use python-sdk for core SDK changes"), giving it a clear niche with minimal conflict risk, matching the level-5 anchor exactly.

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