CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

supply-chain-security

Activate when reviewing or modifying dependency resolution, lockfile schema, package downloaders, signature/integrity checks, file integration cleanup, or anything that could expose APM to dependency confusion, typosquatting, malicious packages, or token leakage.

Quality

73%

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 ./.apm/skills/supply-chain-security/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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 a tight, high-signal checklist: precise activation triggers and named enforcement points (path_security.py, remove_stale_deployed_files(), AuthResolver) with zero padding. Its main weaknesses are a broken persona reference and details invoked but not defined (the 3 safety gates, AuthResolver usage), plus no verification step to close the review loop.

Suggestions

Fix or remove the dangling persona link '../../agents/supply-chain-security-expert.agent.md' — the file does not exist; either bundle the persona guidance inside the skill or point to a real path within the skill directory.

Briefly enumerate the '3 safety gates' in remove_stale_deployed_files() (or reference a real file that documents them) so the rule is checkable without reading source.

Add a short verification step (e.g., 'before approving, confirm each rule above is satisfied') to give the review workflow an explicit checkpoint.

DimensionReasoningScore

Conciseness

The ~27-line body is lean and efficient: every bullet in 'When to activate' and 'Key rules' carries unique information (file paths, function names, policy directives) with no padding or explanation of concepts Claude already knows. Matches anchor 5 — every token earns its place.

5 / 5

Actionability

Guidance is concrete and executable for a review skill: 'All path construction routes through src/apm_cli/utils/path_security.py', 'route through integration/cleanup.py:remove_stale_deployed_files() (3 safety gates)', 'never raw os.getenv', with exact symbols and one fail-closed directive. Not 5 because key details are referenced but unexplained — what the '3 safety gates' are and how AuthResolver is invoked are left as lookups with no pointer.

4 / 5

Workflow Clarity

As a single-purpose review skill the structure is unambiguous: a clearly delimited 'When to activate' section followed by the 'Key rules' to enforce, each rule phrased as a checkable directive. Not 5 because there is no verification or sign-off checkpoint (e.g., how to confirm each rule is satisfied before approving a change), which leaves the review sequence implicit.

4 / 5

Progressive Disclosure

The body is under 50 lines with well-organized sections and no inlined bulk that belongs in separate files, which by itself would score 5. The single reference — '[Supply chain security expert persona](../../agents/supply-chain-security-expert.agent.md)' — is a dangling link to a nonexistent file outside the skill directory, breaking navigation and violating the one-level-deep, clearly-signaled pattern.

4 / 5

Total

17

/

20

Passed

Description

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

The description is a strong, specific trigger statement with excellent domain keywords, but it is half a description: it says precisely when to activate while never saying what the skill does when activated. Adding a one-clause capability statement ('Reviews dependency changes for supply-chain risks and enforces...') anchored to its rules would lift completeness sharply.

Suggestions

Add a leading 'what' clause stating the skill's capabilities (e.g., 'Reviews and hardens dependency management code...') before the 'Activate when...' trigger clause, so completeness covers both what and when.

Broaden trigger coverage with natural synonyms a user would say, such as 'supply chain attack', 'checksum', 'provenance', and 'vulnerable dependencies'.

Tighten the catch-all 'or anything that could expose APM to...' to bounded conditions to reduce overlap with general security-review skills and improve distinctiveness.

DimensionReasoningScore

Specificity

The description names concrete domain objects — 'dependency resolution, lockfile schema, package downloaders, signature/integrity checks, file integration cleanup' — plus specific threat terms ('dependency confusion, typosquatting, malicious packages, token leakage'), but it states no capability actions the skill itself performs. Not 4 because unlike 'Lists several specific actions', every concrete noun is a trigger condition, not a skill action.

3 / 5

Completeness

The explicit trigger clause 'Activate when reviewing or modifying...' answers 'when' in detail, but the 'what' — what this skill actually does — is entirely absent; the description is only a trigger condition. This matches anchor 2 ('only when is present without what'). Not 3 because anchor 3 requires a clear 'what' to be present, and none is stated; not 1 because the 'when' half is detailed and explicit.

2 / 5

Trigger Term Quality

Good keyword coverage with natural developer phrases like 'dependency resolution', 'lockfile schema', 'signature/integrity checks', 'dependency confusion', 'typosquatting', and 'token leakage'. Not 5 because it misses common synonyms and extensions a user might naturally say ('supply chain', 'checksum', 'provenance', 'requirements.txt' style file names).

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche — APM package-management supply-chain security — with distinct triggers ('dependency confusion, typosquatting, malicious packages, token leakage') unlikely to fire for unrelated skills. Not 5 because the open-ended catch-all 'or anything that could expose APM to...' invites some overlap with a general code-security or review skill.

4 / 5

Total

13

/

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

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

microsoft/apm

Path

.apm/skills/supply-chain-security/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.