Back to Skills

github-issue-writer

verified

Creates well-structured Github issues for the upkeep-io project following standardized templates and best practices. Activate when users need to create or format issues for Upkeep-Io repository.

View on GitHub

Marketplace

upkeep-io-marketplace

daveharmswebdev/upkeep-io

Plugin

upkeep-io-plugin

Repository

daveharmswebdev/upkeep-io

upkeep-io-plugin/skills/github-issue-writer/SKILL.md

Last Verified

January 21, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/daveharmswebdev/upkeep-io/blob/main/upkeep-io-plugin/skills/github-issue-writer/SKILL.md -a claude-code --skill github-issue-writer

Installation paths:

Claude
.claude/skills/github-issue-writer/
Powered by add-skill CLI

Instructions

# Github Issue Writer

## Instructions

You are assisting with drafting a high-quality Github Issues following Upkeep-Io standardized format.

### Issue Structure

Create Issue using the following structure:

1. **User Story Format** (for features/enhancements):
   ```
   As a [user type/role]
   I want to [action/capability]
   So that [benefit/value]
   ```

2. **Context Section**:
   - Provide background information and business justification
   - Explain how this fits into the larger product strategy
   - Include references to related work or dependencies
   - Clearly identify what's in and out of scope

3. **Success Criteria**:
   - Write specific, testable acceptance criteria as scenario blocks
   - Format as "Given/When/Then" statements
   - Group related criteria under descriptive headers
   - Each criterion should be independently verifiable

4. **Technical Requirements**:
   - Separate requirements by domain (Frontend, Backend, etc.)
   - Include implementation guidelines, patterns, and approaches
   - Specify security considerations
   - Reference design materials when available

5. **Definition of Done**:
   - Include a checklist of completion criteria
   - Cover testing requirements, documentation, and reviews

### Best Practices

- **Be Specific**: Avoid vague language; use concrete, measurable terms
- **Be Comprehensive**: Ensure all aspects of implementation are covered
- **Be User-Focused**: Connect technical requirements to user value
- **Be Realistic**: Break large tasks into manageable pieces
- **Prioritize Security**: Always include relevant security considerations

### Process (MANDATORY ORDER)

1. Ask clarifying questions to gather necessary details
2. **RESEARCH GATE (blocking):**
   - Use `mcp__Ref__ref_search_documentation` for technical requirements
   - Use `mcp__firecrawl__firecrawl_search` for domain/compliance requirements
   - Document sources consulted in your response
3. Structure information into the template sections
4. Cite sourc

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
2192 chars