easy-issues
Skill21 starsChanged 47 days agoMITView on GitHub
Find and work through easy issue-tracker tasks autonomously, simplest first, using one fresh subagent per issue in sequence. Use for clearing straightforward bugs, documentation fixes, and tiny features without operator help.
In this repository28 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- breakdownSkill
- bug-investigationSkill
- cleanupSkill
- code-review-adversarialSkill
- code-review-multiSkill
- code-review-with-followupSkill
- document-changesSkill
- grillingSkill
- type-test-codeSkill
- explain-changesSkill
- github-actions-ciSkill
- github-appSkill
- github-ticketsSkill
- implementation-planSkill
- implement-simpleSkill
- implementSkill
- implement-ttcSkill
- orchestrationSkill
- pull-requestSkill
- review-and-wrap-upSkill
- verusSkill
- specSkill
- ticketsSkill
- update-working-copySkill
- verifySkill
- wrap-upSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
14 rules. About 0 are common, 10 are distinctive, and 4 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈10
Distinctive · estimate
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 11
Use /orchestration to manage subagents.
- Distinctive: line 12
Keep the coordinator focused on triage and handoffs.
- Very specific: line 22
Read open issues, including their descriptions, relevant comments, dependencies, and linked work.
- Distinctive: line 33
When you find a very straightforward and simple issue, go ahead and work that one first.
- Very specific: line 39
Use a separate branch/worktree for each issue.
- Very specific: line 40
Use /orchestration to start a fresh subagent without inherited conversation history.
- Distinctive: line 43
Read repository instructions and the full issue.
- Distinctive: line 51
Update the issue's progress artifact incrementally.
- Distinctive: line 59
If an issue needs help, write a progress summary in its artifacts and on the issue if authorized.
- Distinctive: line 62
If an issue is completed, inform the user without waiting for a response.
- Distinctive: line 64
Check for quota exhaustion and operator stop instructions before starting another issue.
- Distinctive: line 67
If access, quota, configuration, etc is blocking you from finishing an issue, stop rather than attempting every issue against the same …
- Distinctive: line 72
After stopping, give a short status report.
- Distinctive: line 81
When no candidates remain, check for new issues before declaring that no simple issues remain.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Easy issues
Work through the project's open issues until no simple work remains, quota is exhausted, or the operator says to stop.
Use /orchestration to manage subagents.
Keep the coordinator focused on triage and handoffs; delegate investigation and
implementation. Run only one issue at a time, including its child workflows.
Finish or stop that issue's agents before starting another, so several issues
cannot exhaust quota together.
Find and rank work
Identify the project's tracker from repository instructions and remotes. Use its configured access workflow.
Read open issues, including their descriptions, relevant comments, dependencies,
and linked work. Labels such as good first issue are hints, not requirements or proof of simplicity.
Skip issues already being implemented or covered by an open PR.
Find small changes with clear intended behavior and verification that an agent
can complete without operator input. Typical candidates are documentation fixes,
obvious bugs, and tiny features such as changing the text of a message. Exclude
work requiring product decisions, unavailable access, operator-only reproduction,
unresolved dependencies, or broad design changes.
Label these issues with an agreed upon label such as simple or good first issue.
When you find a very straightforward and simple issue, go ahead and work that one first. Otherwise go through issues and rank them by expected total effort and uncertainty and work the simplest issues first.
Working an issue
Use a separate branch/worktree for each issue.
Use /orchestration to start a fresh subagent without inherited conversation history.
Give it the issue link, repository and artifact paths, relevant constraints, and this assignment:
- Read repository instructions and the full issue. Confirm the task is clear, small, unclaimed, and solvable without operator help.
- Determine a solution. For a non-obvious bug, use
/diagnosing-bugs. If the investigation reveals substantial scope or needs operator input, checkpoint and return instead of expanding the task or waiting for an answer. - Once the solution is determined, use
/implement-simpleto implement, verify, review, and finish it. Follow that workflow's existing authorization rules for commits, PRs, and tracker updates. - Update the issue's progress artifact incrementally. Return a concise status: completed, needs operator help, complicated, or quota exhausted. Include findings, changes, verification results, branch/worktree and commit/PR links, remaining work, and the exact input needed to continue, when applicable.
Continuing to next issues
If an issue needs help, write a progress summary in its artifacts and on the issue if authorized. Label the issue with an agreed upon label and continue to the next candidate issue without waiting for the operator.
If an issue is completed, inform the user without waiting for a response.
Check for quota exhaustion and operator stop instructions before starting another issue.
If access, quota, configuration, etc is blocking you from finishing an issue, stop rather than attempting every issue against the same blocker.
Stop and report
After stopping, give a short status report. Report why the run stopped and summarize completed work with issue and commit/PR links. Then list issues needing triage or operator help, ordered by how easy they are for the operator to unblock: a quick answer or supplied example before reproduction work or a larger design decision. For each, state progress, the precise question or next action, and where partial work is saved. Distinguish deferred issues from candidates not attempted before stopping; disclose any uninspected backlog rather than claiming it contains no easy work.
When no candidates remain, check for new issues before declaring that no simple issues remain.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

