CtrlK
BlogDocsLog inGet started
Tessl Logo

gh-bulk-issues

Orchestrate parallel Mastra Code headless instances to debug and fix multiple GitHub issues simultaneously

61

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 ./.mastracode/skills/gh-bulk-issues/SKILL.md
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.

The body is a strong, lean operational playbook: concrete commands, an explicit monitoring cadence, restart/feedback loops for every failure mode, and untrusted-output validation before PRs. Its only real gaps are an unresolved path placeholder and dependence on sibling skills whose conventions are not bundled. It is close to exemplary for an instruction-only orchestration skill.

DimensionReasoningScore

Conciseness

The body is lean and command-driven — worktree creation, build limits, spawn commands, a 3-minute monitoring cadence, and a tight Key Rules section — with no explanation of concepts Claude already knows; only the brief supervisor-role restatement of the description keeps it from being pure anchor 5, and that line still orients the agent usefully, so anchor 5 ('lean and efficient; every token earns its place') is the best fit over anchor 4.

5 / 5

Actionability

Most guidance is copy-paste executable ('git worktree add ../$(basename $PWD)-issue-<NUMBER> -b fix/issue-<NUMBER>', 'pnpx tsx <path-to-mastracode>/src/main.ts --timeout 1800', 'gh pr checks <PR_NUMBER>'), but the unresolved '<path-to-mastracode>' placeholder and reliance on the undocumented '/gh-new-pr conventions' are minor gaps, fitting anchor 4 ('mostly executable; minor gaps') rather than anchor 5's fully copy-paste-ready bar.

4 / 5

Workflow Clarity

The sequence is explicit (inputs → worktree setup → parallel spawn → 3-minute monitoring → timeout/restart → PR creation → comment handling → CI checks) with validation checkpoints ('Check git diff --stat', 'Review all mc output before creating PRs — subagent work is untrusted'), feedback loops for every failure mode (timeout restart with continuation context, CI fix instances, PR comment instances), and a Key Rules checklist — anchor 5. This batch operation includes validation, so the workflow cap does not apply.

5 / 5

Progressive Disclosure

No bundle files exist and none are needed for this orchestration skill; the body is well-sectioned and self-contained. It falls just short of anchor 5 because it leans on external skill references ('/gh-new-pr conventions', '/gh-pr-comments', '/gh-fix-ci') whose conventions are not available in the bundle — a minor organization gap matching anchor 4 ('good structure; minor organization gaps').

4 / 5

Total

18

/

20

Passed

Description

58%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 specific and distinctive, clearly stating a concrete capability set around parallel GitHub issue resolution. Its main weakness is the absence of any 'Use when...' trigger clause and of natural trigger synonyms, leaving a user (and the skill router) without explicit invocation guidance. Adding an explicit when-to-use clause would raise both completeness and trigger-term quality.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user wants to fix, debug, or resolve multiple GitHub issues at once, in parallel, or in bulk.'

Include natural user phrasings and synonyms such as 'many issues', 'batch', 'several issues at the same time' to improve trigger-term coverage.

Briefly mention the downstream actions (review diffs, open PRs, address CI and review comments) so the stated capabilities match the skill's full scope.

DimensionReasoningScore

Specificity

The description names its domain and several concrete actions — 'Orchestrate parallel Mastra Code headless instances to debug and fix multiple GitHub issues simultaneously' — but omits parts of the actual scope (monitoring, PR creation, CI fixes), matching anchor 4 ('several specific actions; minor gaps') rather than anchor 5's comprehensive coverage; it is clearly above anchor 3's '1-2 concrete actions'.

4 / 5

Completeness

The 'what' is clear (orchestrate parallel headless instances to debug and fix multiple GitHub issues), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which per the judging guidelines caps completeness at 3 ('clear what but when is missing or only weakly implied').

3 / 5

Trigger Term Quality

Relevant keywords exist ('GitHub issues', 'debug', 'fix', 'parallel', 'Mastra Code') but common natural variations a user would say are missing ('many issues at once', 'batch', 'bulk'), matching anchor 3 ('some relevant keywords but missing common variations or synonyms') — below anchor 4's good coverage and above anchor 2's one-or-two generic terms.

3 / 5

Distinctiveness Conflict Risk

The niche pairing of 'Mastra Code headless instances' with 'multiple GitHub issues simultaneously' is distinctive, matching anchor 4 ('mostly distinct; minor overlap risk') — it could still collide with a generic single-issue-fixing skill, so not anchor 5, but it is far more specific than anchor 3's 'works with document files' level of overlap.

4 / 5

Total

14

/

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

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository
mastra-ai/mastra
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.