fix-github-issue— agent skill

Usage: /fix-github-issue ISSUE_NUMBER

Example: /fix-github-issue 276

Fix GitHub issue $ARGUMENTS following best practices.

Setup:

1. Read .claude/PROJECT_CONTEXT.md for AgnosticUI structure, conventions, and workflows

Steps:

1. Verify we're starting from a clean state:

• Check git status to ensure working directory is clean
• Confirm we're on master branch
• If not clean or on wrong branch, STOP and ask user to resolve

1. Create a feature branch:

• Follow convention from PROJECT_CONTEXT: issue-$ARGUMENTS/descriptive-name
• Example: issue-276/fix-button-variant
• Use git checkout -b issue-$ARGUMENTS/[short-description]
• WAIT FOR USER APPROVAL of branch name

1. Analyze the issue:

• Use gh issue view $ARGUMENTS to fetch full issue details
• Understand the problem, reproduction steps, and expected behavior

1. Investigate the codebase:

• Use PROJECT_CONTEXT to identify relevant locations:
• Core components in v2/lib/src/components/
• Framework implementations in playgrounds
• Related tests and examples
• Use Read, Grep, and Glob to find relevant files
• Review current implementation and identify root cause

1. Propose the fix:

• Explain what needs to change and why
• Consider impact across Lit, React, and Vue if applicable
• Follow AgnosticUI's CSS-first, accessibility-focused principles
• Show the user your proposed changes
• WAIT FOR USER APPROVAL before making any changes

1. Implement only after approval:

• Make the necessary code changes
• Update related files (tests, docs, examples) if needed
• Run tests if applicable (check PROJECT_CONTEXT for test commands)
• Verify the fix addresses the issue

1. Prepare commit:

• Stage changes with git add
• Create descriptive commit message: "Fix #$ARGUMENTS: [description]"
• Show the user what will be committed
• WAIT FOR USER APPROVAL before committing

1. Inform user about next steps:

• Remind user they're on branch issue-$ARGUMENTS/...
• Explain they should review changes with git diff master
• When ready, they can: git push -u origin issue-$ARGUMENTS/...
• Then create PR with: gh pr create --base master --head issue-$ARGUMENTS/...

Important Rules:

• ALWAYS create a feature branch - NEVER work directly on master
• NEVER push to remote without explicit user permission
• ALWAYS show proposed changes before implementing
• STOP and ask for approval at each major step
• Use clear, descriptive commit messages that reference the issue
• Follow AgnosticUI conventions from PROJECT_CONTEXT