CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

autopilot-issue-triage-scheduler

Queue open microsoft/apm issues and fan them out through an isolated pool (default 2) of autopilot-issue-triage-worker sessions. Advisory only. Never implements, never assigns, never requests reviewers. Activate on a mixed issue list or queue-all when the job is triage. Works in a local session, Copilot App automation, Cloud Agent, Remote Agent, or Agentic Workflow.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 highly operational, fail-closed scheduler manual: executable commands with flag-level variants, a mandated pre-spawn queue table, stop-on-failure validation gates, and a well-signaled one-level reference to the fan-out pool. The only real costs are systematic repetition of the write-prohibition rules and dense inline detail in the scheduled-sweep section that could be offloaded to a reference file.

Suggestions

Consolidate the write-prohibition rules (stated in the intro, Activation card rules, Invocation, Selection, and Hard nos) into one canonical section and reference it, reclaiming redundant tokens.

Move the scheduled-sweep eligibility details (exclusion labels, evidence requirements, five-item cap semantics) into a short reference file and keep only the invocation contract inline.

Add one filled example row to the keep-set/drop-set table spec so the mandatory format is unambiguous on first use, and fix or contextualize the ../autopilot-issue-triage-worker/SKILL.md relative link.

DimensionReasoningScore

Conciseness

The body is dense, imperative, and free of concept explanations Claude already knows, but the write-prohibition ("never comments, labels, assigns, or requests reviewers") is restated across ~5 sections and the Invocation "Ownership writes" list describes writes ("Code (accepted implementation): assign the implementing user") this scheduler never performs; this is more than zero padding but stays minor, fitting anchor 4 rather than anchor 5.

4 / 5

Actionability

Fully executable guidance throughout: copy-paste commands ("python <this-skill>/scripts/fetch_queue.py --kind issue --mode sweep --repo microsoft/apm > batch.json"), exact flag variants (--mode dispatch --number N, --records-json, --labels-json, --scheduled-sweep), field-by-field activation card templates, and an exact queue-table column spec, covering the default, named-issue, and scheduled-sweep cases.

5 / 5

Workflow Clarity

The 5-step Procedure is clearly sequenced and saturated with explicit validation gates for this batch fan-out: "Missing -> stop" (probe), "Missing table, missing column, or blank rationale -> stop. Do not spawn.", "A helper failure stops the run", "Incomplete evidence fails the sweep", plus the Exit receipt and final report; validation is present so the batch-operation cap does not apply, matching anchor 5.

5 / 5

Progressive Disclosure

Against the actual bundle, assets/fan-out-pool.md is explicitly linked ("Load [assets/fan-out-pool.md](assets/fan-out-pool.md)") one level deep and scripts/fetch_queue.py, scripts/triage_state.py, and assets/label-contract.json are named as canonical owners; however the dense scheduled-sweep eligibility rules are inline rather than split to a reference, the queue-table spec lacks a filled example row, and the relative link ../autopilot-issue-triage-worker/SKILL.md has no target in this bundle, so anchor 4 fits rather than 5.

4 / 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: it states concrete capabilities in third person, draws a sharp advisory-only boundary against sibling schedulers, and includes an explicit activation clause. Its only weaknesses are trigger phrases that lean on internal mode names ("queue-all", "mixed issue list") rather than natural user vocabulary, and leaving the advisory output of the workers only implied.

Suggestions

State what the fan-out actually produces (e.g., advisory triage recommendations per issue) so the "what" covers the outcome, not just the mechanics of queueing and slotting.

Add one or two natural user-facing synonyms for the trigger, such as "triage the issue backlog" or "sweep open issues", to broaden trigger matching beyond internal mode names like "queue-all".

DimensionReasoningScore

Specificity

"Queue open microsoft/apm issues", "fan them out through an isolated pool (default 2) of autopilot-issue-triage-worker sessions", and "Never implements, never assigns, never requests reviewers" list several concrete actions with minor coverage gaps; what the workers produce is only implied by "Advisory only", so it falls just short of the comprehensive anchor 5 and clearly above the 1-2-action anchor 3.

4 / 5

Completeness

Both questions are answered explicitly: what ("Queue open microsoft/apm issues and fan them out through an isolated pool (default 2) ... Advisory only") and when ("Activate on a mixed issue list or queue-all when the job is triage") with concrete trigger phrases, matching anchor 5; the use-when clause is present so no cap applies.

5 / 5

Trigger Term Quality

Natural terms like "triage", "issues", "queue", "queue-all", and "microsoft/apm" give good keyword coverage, but common synonyms (backlog, categorize, label) are missing and some triggers are internal jargon ("queue-all", "Agentic Workflow"), matching anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

"issues" plus "Advisory only. Never implements, never assigns, never requests reviewers" cleanly separates it from delivery and PR-review siblings, but "triage" remains a shared trigger with the closely related PR-triage scheduler, fitting anchor 4 (mostly distinct, minor overlap risk) rather than anchor 5's minimal-conflict niche.

4 / 5

Total

17

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 1 suspicious

Warning

Total

14

/

16

Passed

Repository

microsoft/apm

Path

.agents/skills/autopilot-issue-triage-scheduler/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.