Create Issues
Productivitycreate-issuesCreate Issues is an Agent Skill for productivity published in the FradSer/dotclaude repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Creates GitHub issues following test-driven development principles and proper labeling conventions. This skill should be used when the user asks to "create an issue", "file a bug", or needs to document new requirements, epics, or PR-scoped tasks.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/FradSer/dotclaude/blob/HEAD/github/skills/create-issues/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/create-issues, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Create GitHub Issues
Execute automated GitHub issue creation workflow for $ARGUMENTS following TDD principles and conventional commit standards.
Context
- Current git status: !
git status - Current branch: !
git branch --show-current - Open issues: !
gh issue list --state open --limit 10 - GitHub authentication: !
gh auth status
Requirements Summary
Follow TDD principles, conventional commits, and protected branch workflows. Use proper labels, auto-closing keywords, and atomic commits. See references/requirements.md for complete standards.
Phase 1: Repository Analysis
Goal: Assess repository state, detect templates, and determine issue scope and type.
Actions:
- Analyze current branch from context (main/develop vs PR branch)
- Review open issues to identify duplicates or related work
- Check for contributing guidelines (
CONTRIBUTING.md) and follow its requirements - Detect issue templates in
.github/ISSUE_TEMPLATE/directory - If templates exist: select appropriate template using
gh issue create --list - Determine issue type (epic, PR-scoped, or review) based on
$ARGUMENTScomplexity - Apply branch-based decision logic from
references/decision-logic.md
See references/repository-templates.md for template detection and compliance details.
Phase 2: Issue Creation
Goal: Create GitHub issue with proper structure, labels, and links.
Actions:
- Create or verify required priority labels exist (see
references/decision-logic.mdfor commands) - Draft issue following structure requirements in
references/issue-structure.md - Apply appropriate labels (priority, type) using
--label- Assign owners using
--assignee - Link milestones using
--milestoneor projects using--projectif requested
- Assign owners using
- Add auto-closing keywords if PR-scoped issue (NOT for epics)
- CRITICAL: Auto-closing keywords (
Closes/Fixes/Resolves #N) only trigger when the PR merges into the repository's default branch (usuallymain/master). If the issue will be resolved by a PR targeting a non-default branch (e.g.develop), warn the user that the issue will NOT close automatically and must be closed manually.
- CRITICAL: Auto-closing keywords (
- Link to related issues or epics if applicable
Phase 3: Documentation and Handoff
Goal: Document decisions and communicate follow-up actions.
Actions:
- Document branch strategy decision and rationale
- Report created issue number and URL to user
- If on PR branch and blocking: add detailed comment to PR instead of creating issue
- Share next steps (create PR, assign to team member, etc.)
References
- Requirements:
references/requirements.md- Full TDD and commit standards - Decision Logic:
references/decision-logic.md- Branch-based decisions and issue types - Issue Structure:
references/issue-structure.md- Title, labels, body, auto-closing - Repository Templates:
references/repository-templates.md- Contributing guidelines and issue templates - Examples:
references/examples.md- Commit message examples