deerflow-maintainer-orchestrator

Use when a DeerFlow maintainer needs comment-only GitHub issue or PR handling: resolve issue/PR scopes with gh, analyze issues, post or draft issue comments, perform PR review comments, review PR or issue batches, compare competing PRs that target the same issue, give fix strategy, risk classification, and validation guidance. Intended for maintainers and trusted local agents, not general contributors.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

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 content is highly actionable with concrete commands, templates, and a clear sequenced workflow including posting gates and validation guidance. It is mostly concise and well-structured, with only minor tightening and reference-splitting opportunities preventing top marks.

Suggestions

Trim restated directives (e.g., repeated "do not ask the maintainer" / "Do not ask" phrasing across Core Rule, Artifact Resolution, and No-Question Policy) into a single canonical statement to improve conciseness.

Move the detailed Diff Base Rule git invocation reference and the Validation Guidance table into a bundled reference file, keeping SKILL.md as a tighter overview with clearly signaled one-level-deep links.

Strengthen workflow_clarity by making validation an explicit numbered checkpoint with a fix-and-retry loop in the PR Review Flow and Issue Flow, rather than a recommended check.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient and assumes Claude's competence, but a few sections (e.g., the lengthy Diff Base Rule and repeated "do not ask" phrasing) could be tightened; minor instances of restatement keep it just below a lean score-5.	4 / 5
Actionability	Provides concrete, copy-paste-ready `gh` commands, exact JSON field lists, git fetch/diff invocations, and complete comment/review/output templates covering the common cases, matching the score-5 anchor.	5 / 5
Workflow Clarity	Multi-step flows (Artifact Resolution, Issue Flow, PR Review Flow) are clearly sequenced with refresh-before-posting and Posting Gate checkpoints, but some validation steps are described as guidance rather than enforced feedback loops, leaving minor checkpoint gaps.	4 / 5
Progressive Disclosure	Well-organized into clearly headed sections (Core Rule, Artifact Resolution, Issue Flow, PR Review Flow, Batch Handling, etc.) with appropriate inlining of overview guidance, but there are no one-level-deep reference files to offload detail; structure is good without being a clean score-5 split.	4 / 5
	Total	17 / 20 Passed

Description

92%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, complete, and distinctive, with explicit "Use when" trigger guidance and a clear maintainer-only niche. Trigger-term coverage is strong but not maximally exhaustive of every synonym, keeping that one dimension at 4.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions — "resolve issue/PR scopes with gh, analyze issues, post or draft issue comments, perform PR review comments, review PR or issue batches, compare competing PRs" — giving comprehensive coverage of capabilities, matching the score-5 anchor.	5 / 5
Completeness	Explicitly answers both what (the enumerated comment/PR/batch/comparison actions) and when ("Use when a DeerFlow maintainer needs comment-only GitHub issue or PR handling") with concrete trigger phrases, matching the score-5 anchor.	5 / 5
Trigger Term Quality	Good keyword coverage with natural terms ("GitHub issue or PR handling", "maintainer", "issue comments", "PR review comments", "competing PRs") users would say, but a few natural phrasings/synonyms are absent; not a level-5 exhaustive list including all variations.	4 / 5
Distinctiveness Conflict Risk	Tightly scoped to "DeerFlow maintainer" comment-only handling and explicitly excludes general contributors, giving a clear niche with minimal conflict risk against other skills.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

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: bytedance/deer-flow
Path: .agent/skills/deerflow-maintainer-orchestrator/SKILL.md
Commit: 2a261d2

Reviewed: about 17 hours ago

Table of Contents

Discovery Implementation Validation

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.