CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

apm-strategy

Activate for changes to project positioning, release communication, community-facing artifacts, or breaking-change decisions in microsoft/apm. Triggers on README, MANIFESTO, PRD, CHANGELOG, release workflows, and issue templates.

54

Quality

68%

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/apm-strategy/SKILL.md
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.

The body is exemplary in token efficiency — a tight trigger list plus five concrete policy rules with no padding. Its main weakness is actionability: the evidence and changelog rules would be far more executable with example gh commands and a sample CHANGELOG entry, and the one external persona reference is broken.

Suggestions

Add 1-2 example gh CLI commands for evidence gathering, e.g. `gh api repos/microsoft/apm/traffic` or `gh pr list --repo microsoft/apm --state open --json author,createdAt`, so the "Ground every claim in gh CLI evidence" rule is directly executable.

Include a one-line CHANGELOG entry + migration-note template (e.g. `## [Unreleased]` with a `**Migration:** ...` line) so the breaking-change rule is copy-paste ready.

Fix or remove the dangling [APM CEO persona](../../agents/apm-ceo.agent.md) link — the referenced file does not exist at that path.

DimensionReasoningScore

Conciseness

A lean ~25-line body of two tight sections with zero concept explanation (it never explains what a CHANGELOG or release pipeline is) and no filler — every line is either a trigger or a rule. Matches anchor 5 ("every token earns its place"); anchor 4 is ruled out because there is nothing that could be trimmed.

5 / 5

Actionability

Rules like "Every breaking change ships with a CHANGELOG.md entry and a one-line migration note" are specific and checkable, but no example gh commands (e.g. gh api repos/{owner}/{repo}/traffic) or CHANGELOG entry template are provided — a real gap for a rule that mandates CLI evidence. Falls between anchor 3 ("missing key details") and 4 ("concrete code or commands with minor gaps"); since no commands exist at all, the gap is more than minor.

3 / 5

Workflow Clarity

A simple single-purpose reviewer skill with unambiguous activation triggers (exact paths including .github/workflows/build-release.yml) and individually clear rules; no multi-step process exists, so no validation checkpoints are needed. Scored below 5 because the arbitration path ("Final arbiter when... reviewers disagree") and the order of operations remain implicit.

4 / 5

Progressive Disclosure

Under 50 lines with well-organized sections and one external reference, [APM CEO persona](../../agents/apm-ceo.agent.md), but that path does not resolve (no agents/ directory exists at the referenced location). Good structure with a dangling navigation link is anchor 4 ("minor organization gaps"), not 5.

4 / 5

Total

16

/

20

Passed

Description

47%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 has strong, explicit trigger guidance and a distinct repo-scoped niche, but it omits any statement of what the skill actually does — a reviewer/enforcer of positioning and release-communication standards. Adding 2-3 concrete capability verbs would resolve the completeness gap, which is the dominant weakness.

Suggestions

Add 2-3 concrete capability statements before the trigger clause, e.g. "Reviews project positioning claims, enforces changelog/migration policy for breaking changes, and triages community-facing communications in microsoft/apm."

Include natural trigger synonyms users would say, such as "release notes", "deprecation", "version bump", and file extensions like README.md / CHANGELOG.md, to round out trigger coverage.

Keep the "Activate for..." phrasing but pair it with an explicit "what" so both halves of the what/when pair are present in one sentence.

DimensionReasoningScore

Specificity

The domain is named precisely ("project positioning, release communication, community-facing artifacts, or breaking-change decisions in microsoft/apm"), but the description states no actions the skill performs — no capability verbs at all. This matches anchor 2 ("Names the domain but actions are minimal or generic") rather than 3, which requires 1-2 concrete actions; it is above 1 because it is not entirely vague.

2 / 5

Completeness

The "when" is explicit ("Activate for changes to..." / "Triggers on..."), but the "what" is entirely absent — the description never says what the skill does once activated. This matches anchor 2 ("only 'when' is present without 'what'") exactly; anchor 3 is ruled out because it requires a clear "what".

2 / 5

Trigger Term Quality

"README, MANIFESTO, PRD, CHANGELOG, release workflows, and issue templates" plus "breaking-change" are concrete artifacts a maintainer would naturally mention. Missing file extensions (.md, .yml) and synonyms like "release notes" or "deprecation", so it falls short of anchor 5's comprehensive coverage but clearly exceeds anchor 3's "missing common variations".

4 / 5

Distinctiveness Conflict Risk

Scoped to "microsoft/apm" with repo-specific artifacts (MANIFESTO, PRD, issue templates, build-release.yml) giving it a clear niche. Minor overlap risk remains for common files like README.md and CHANGELOG.md that generic docs skills also target, keeping it below anchor 5.

4 / 5

Total

12

/

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/apm-strategy/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.