lbussell/create-issue
skills/create-issue/SKILL.md
Draft and create GitHub issues in Logan Bussell's preferred style. Use when the user asks to file, open, draft, or create an issue, especially for bug reports, CI failures, or feature requests.
testing
Updated May 12, 2026
$ install --global
skillsauthnpx skillsauth add lbussell/agent-skills create-issueInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 12, 2026, 6:52 AM196.9s1 file scanned
SKILL.md
- name:
- create-issue
- description:
- >-
- user-invocable:
- true
- disable-model-invocation:
- true
Workflow
- Gather the target repository, issue type, and relevant evidence.
- Draft a title and body using the style guide below.
- Show the draft to the user unless they explicitly asked to create it without confirmation.
- Create the issue with
gh issue create --repo <owner/repo> --title "<title>" --body "<body>".
Style guide
Write issues in a direct, actionable style:
- Use a concise title naming the affected component and desired outcome or failure, e.g.
Validate signatures before publishing images. - Start the body with the current state, failure, or motivation. Prefer concrete openers like
Currently, ...,The <workflow> is failing ..., orI like <tool>, and it would be easier if .... - Include evidence immediately after the opener: exact links to runs, PRs, code lines, screenshots, commands, or error text.
- If the cause is known, explain it briefly with
This means ...,That does not satisfy ..., orThe <label/setting> is only added when .... - End with the requested behavior using
We should ...,Instead, ..., orThis would .... - Keep paragraphs short. Use bullets for examples, alternatives, or affected items. Do not use checklists unless the user explicitly asks for one.
- Use backticks for code identifiers, labels, commands, config keys, file names, branch names, and literal issue text.
- Avoid filler, speculation, and long background. If the root cause is unknown, say what needs investigation instead of guessing.
Bug or failure report style
Use this style for broken behavior, CI failures, regressions, automation bugs, and usability failures.
<Current behavior or symptom in one sentence.>
<Evidence link, screenshot, code link, or failing run.>
```text
<Exact error text, if available.>
```
<Brief root cause or why this is actionable, if known.>
<Expected behavior or requested fix.>
Notes:
- Lead with the failure, not the proposed fix, unless the fix is obvious.
- Include the smallest useful evidence: exact workflow run, job, PR, source line, screenshot, or failing command.
- For auto-generated or recurring failures, explain whether the issue should stay open, deduplicate, notify differently, or update metadata.
- If multiple items are affected, list them as bullets after the evidence.
Feature request style
Use this style for enhancements, workflow improvements, distribution requests, validation hardening, and policy changes.
<Motivation or current limitation in one short paragraph.>
<Proposed change using "We should ..." or "Instead, ...".>
<Concrete examples, commands, configuration, or implementation direction.>
<Constraints, tradeoffs, or rollout notes, if relevant.>
Notes:
- Make the benefit explicit: easier installation, fewer duplicate issues, safer publishing, better readability, stronger validation.
- Prefer a concrete proposal over an abstract wish. Include commands or sample config when the request changes user workflow.
- Mention opt-in behavior, compatibility limits, or security requirements when they materially affect implementation.
Examples
Bug/failure report
The `check-markdown-links` workflow is failing during action setup before link checking runs.
Failure from PR #7175: https://github.com/example/repo/actions/runs/123/job/456
```text
The action example/action@sha is not allowed because all actions must match the allowed-actions policy.
```
The workflow uses `example/action@v1`, which attempts to fetch `example/action` by SHA. That does not satisfy the current allowed-actions policy, so the workflow cannot run successfully.
Feature request
Currently, every failure creates a new GitHub issue. If the same failure occurs repeatedly, duplicate issues accumulate.
Instead, `NotificationService` should detect an existing open issue for the same failure and update it rather than opening a new one.
A deduplication key, such as subscription name or manifest/repo, could be added to the notification metadata.
Related Skills
lbussell/triaging-issues
development
VerifiedTrustedCommunity
Triage issues labeled 'untriaged' in a repository. Investigates each issue, correlates with recent activity, and categorizes into: customer issue, ready for work, needs investigation, or already addressed. Informational only — does not modify issues.
SKILL.mdUpdated May 21, 2026
lbussell/creating-pull-requests
tools
VerifiedTrustedCommunity
Open a pull request on GitHub. Use when the user asks to open or create a pull request on GitHub.
SKILL.mdUpdated May 14, 2026
lbussell/creating-issues
devops
VerifiedTrustedCommunity
Open an issue on GitHub. Use when the user asks to file/open/draft/create an issue. Useful for bug reports, pipeline failures, feature requests, etc.
SKILL.mdUpdated May 14, 2026
lbussell/triage-pull-requests
development
VerifiedTrustedCommunity
Triage open pull requests in a repository into actionable categories: ready to merge, needs review, needs action, stale, waiting. Use for daily PR triage to quickly identify what needs attention.
SKILL.mdUpdated May 12, 2026