CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

apm-assist

Explain APM, answer documentation questions, inspect installations and help with setup or migration.

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 ./skills/apm-assist/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 an efficient, well-structured instruction skill: it provides specific commands, files, and URLs, and its installation-inspection and migration workflows include approval and preservation checkpoints. The main gaps are a few abstract steps in the Answers section and the absence of an explicit error-recovery loop after validation checks.

DimensionReasoningScore

Conciseness

The body is lean and every sentence carries tool-specific knowledge Claude cannot already have ("APM coordinates work across AI assistants using planning documents, a file-based Message Bus and persistent work records"; the compact docs table; the metadata.json key list). There is no padding, no general-concept explanation, and no verbosity to trim, matching the 'lean and efficient; every token earns its place' anchor.

5 / 5

Actionability

Guidance is mostly executable: exact commands ("npm install -g agentic-pm", "apm --version", "apm status", "apm init -a agents claude"), a specific file with named keys (".apm/metadata.json for source, repository, releaseVersion..."), and concrete URLs to fetch. It is not 5 because some steps remain abstract ("Fetch the page relevant to the question", "verify behavior against the matching code or templates") without examples of how to do them.

4 / 5

Workflow Clarity

Sections 3 and 4 give clear numbered sequences with real checkpoints around destructive operations — "Obtain approval before modifying the installation", "verify preservation before cleanup", "check it with apm status" — matching 'clear sequence with most checkpoints present'. It is not 5 because there is no explicit validate-then-fix-then-retry feedback loop (e.g., what to do when apm status reports a problem after migration).

4 / 5

Progressive Disclosure

The skill is well organized into five clear sections with a compact, appropriately-inline documentation index acting as one-level-deep navigation, matching 'good structure; most content is appropriately placed'. It is not 5 because the body exceeds the under-50-line simple-skill threshold and the docs table plus role descriptions could plausibly live in a reference file if the skill grows.

4 / 5

Total

17

/

20

Passed

Description

55%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 states a clear set of capabilities in concise third person, but omits any explicit 'when to use' trigger guidance and lacks natural synonym coverage, so it reads as a capability list rather than an invocation trigger. It is also at moderate conflict risk because 'APM' is ambiguous and the setup/migration phrasing is broad.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks about APM (Agentic Project Management), its Planner/Manager/Worker workflow, or needs help installing, updating, or migrating an APM installation."

Include natural synonyms and concrete nouns users would type — "agentic project management", "agentic-pm", "APM CLI", ".apm directory" — to improve trigger term coverage and disambiguate from Application Performance Monitoring.

Name concrete artifacts/actions instead of "help with", e.g. "inspect .apm/ session records and metadata.json, run apm status, guide setup or migration".

DimensionReasoningScore

Specificity

"Explain APM, answer documentation questions, inspect installations and help with setup or migration" lists several concrete actions (explain, answer doc questions, inspect installations, setup/migration), matching the 'several specific actions; minor gaps' anchor. It is not 5 because two actions are qualified by the generic "help with" and coverage is not comprehensive (no commands, file paths, or artifacts named).

4 / 5

Completeness

The 'what' is clear (four stated capabilities) but 'when' is entirely absent — there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is not 4 because nothing in the description signals when to invoke the skill.

3 / 5

Trigger Term Quality

Keywords like "APM", "documentation", "installations", "setup", "migration" are relevant, but common variations users would naturally say are missing ("agentic project management", "agentic-pm", "upgrade", "APM CLI"), matching the 'some relevant keywords but missing common variations or synonyms' anchor. Not 4 because there is no 'Use when...' phrasing and synonym coverage is thin; not 2 because the terms are domain-relevant rather than purely generic.

3 / 5

Distinctiveness Conflict Risk

"APM" names a niche but collides with the far more common 'Application Performance Monitoring' expansion, and "answer documentation questions" / "help with setup or migration" overlap with generic documentation and setup skills, matching 'somewhat specific but could still overlap with similar skills'. Not 4 because the disambiguation is not strong enough to prevent mis-triggering.

3 / 5

Total

13

/

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

sdi2200262/agentic-project-management

Path

skills/apm-assist/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.