simple-issue-description
Turn a rough bug report, feature request, support note
by every-appFree
Description
Simple issue description is an agent skill that turns a rough bug report, feature request, support note or pull request into a short, plain-language issue. The result is meant to be understood by a maintainer in under a minute, and it focuses on the problem and the behavior someone wants, without prescribing how to build it. The skill reads the notes, conversation, issue, pull request description or diff you give it. For a pull request it also checks any spec, design document or README change, since those often state the intent better than the description. It names the concrete problem and who is affected when the source makes that clear, and keeps only the context that helps someone understand or reproduce the problem. It is strict about evidence: it does not invent user impact, reproduction steps or certainty. If the source only shows cleanup, refactoring or a possible code smell, it says no concrete problem is clear, and it explains what evidence would make it worth filing. If a source bundles several unrelated problems, it drafts the issue for the most significant one, lists the rest one per line, and tells the contributor to split them into separate issues and pull requests. A feature request is described as what users cannot do today and the full experience of the feature. The skill is published by every-app on skills.sh under the open-seo repository, and the listing shows Gen Agent Trust Hub: Pass, Socket: Pass and Snyk: Warn.…
Highlights
- Short issues a maintainer can read in a minute
- Describes the problem and the desired behavior
- Handles pull requests and their specs
- Splits bundled problems into separate issues
- Does not invent impact or reproduction steps
Ratings & Reviews
No ratings yet
Be the first to rate simple-issue-description.
People also visit
gh-issues
Fetch GitHub issues, select candidates, spawn background fix agents, open PRs
simple-issue-description FAQ
What does the skill write?
A short, plain-language issue that focuses on the problem and the desired behavior.
Can it write an issue from a pull request?
Yes. It describes the problem the change tries to solve, not the files it touches, and it also checks spec or design changes.
What if the notes bundle several problems?
It drafts the issue for the most significant one, lists the others in a line each, and advises splitting them into separate issues.
What if no real problem is clear?
It says so in two or three sentences and explains what evidence would make the item issue-worthy.
How do I install it?
Run npx skills add https://github.com/every-app/open-seo --skill simple-issue-description.
What security audits has it passed?
skills.sh lists three audits: Gen Agent Trust Hub Pass, Socket Pass and Snyk Warn. A Warn or Fail is worth reading before you install.
What are the best simple-issue-description alternatives?
Popular alternatives to simple-issue-description include github-ops, od-contribute and github-deep-research. See all simple-issue-description alternatives