submit-issue

Handle user questions, feature requests, and bug reports for connectrpc-axum. This skill should be used when users ask questions about the library, request new features, or report bugs. It first attempts to answer using project documentation, verifies bugs with integration tests, and submits GitHub issues when needed.

⭐8stars🔀1forks📁View on GitHub🕐Updated Jan 3, 2026⬇️1downloads

When & Why to Use This Skill

This Claude skill automates the end-to-end management of user feedback for the connectrpc-axum project. It intelligently triages questions, feature requests, and bug reports by cross-referencing project documentation and executing integration tests. By verifying issues before they reach GitHub, it ensures high-quality repository maintenance and reduces the manual workload for maintainers.

Use Cases

  • Automated Documentation Search: Quickly answer user questions about connectrpc-axum by searching through architecture guides and implementation docs.
  • Bug Verification & Testing: Automatically run integration tests to reproduce reported issues, ensuring only verified bugs are submitted to the issue tracker.
  • Structured GitHub Issue Creation: Generate professionally formatted GitHub issues for bugs and feature requests, including environment details and reproduction steps.
  • Issue Labeling & Organization: Automatically apply appropriate labels like 'bug', 'enhancement', or 'documentation' to new issues using the GitHub CLI.
namesubmit-issue
descriptionHandle user questions, feature requests, and bug reports for connectrpc-axum. This skill should be used when users ask questions about the library, request new features, or report bugs. It first attempts to answer using project documentation, verifies bugs with integration tests, and submits GitHub issues when needed.

Submit Issue

Handle user questions, feature requests, and bug reports for the connectrpc-axum project.

Workflow

1. Understand the Request

Determine the request type:

  • Question: User wants to understand how something works
  • Feature Request: User wants new functionality
  • Bug Report: User believes something is broken

2. For Questions - Answer First

Before suggesting an issue submission, attempt to answer using project documentation:

  1. Read docs/guide/index.md for getting started and features overview
  2. Read docs/guide/architecture.md for internal design and module structure
  3. Check other guides in docs/guide/ for specific topics (configuration, compression, timeouts, etc.)
  4. Reference the connect-go-reference skill for protocol details
  5. Search the codebase for implementation specifics

If the question can be answered from documentation, provide the answer and ask if more clarification is needed.

3. For Bug Reports - Verify First

Before submitting a bug report:

  1. Reproduce the issue - Ask user for reproduction steps if not provided
  2. Run integration tests - Use the /test skill command
  3. Check connect-go behavior - Use connect-go-reference skill to verify expected protocol behavior
  4. Document findings - Note whether tests pass/fail and any discrepancies

Only proceed to issue submission if the bug is verified or plausible.

4. Submit to GitHub

When issue submission is appropriate, use the gh CLI:

# For bug reports
gh issue create \
  --repo "frankgreco/connectrpc-axum" \
  --title "Bug: <concise description>" \
  --body "$(cat <<'EOF'
## Description
<what's broken>

## Steps to Reproduce
1. <step>
2. <step>

## Expected Behavior
<what should happen>

## Actual Behavior
<what happens instead>

## Environment
- connectrpc-axum version: <version>
- Rust version: <version>

## Additional Context
<test results, connect-go comparison, etc.>
EOF
)"

# For feature requests
gh issue create \
  --repo "frankgreco/connectrpc-axum" \
  --title "Feature: <concise description>" \
  --body "$(cat <<'EOF'
## Description
<what you want>

## Use Case
<why you need it>

## Proposed Solution
<how it might work>

## Alternatives Considered
<other approaches>
EOF
)"

5. Label Issues Appropriately

Add labels based on issue type:

  • bug - For verified bugs
  • enhancement - For feature requests
  • question - For questions that need discussion
  • documentation - For docs improvements
gh issue edit <number> --add-label "bug"

Reference Skills

  • connect-go-reference: Use to verify protocol behavior against official Go implementation
  • test: Use to run integration tests and verify bugs

Documentation References

When answering questions, check these docs in order:

  1. docs/guide/index.md - Getting started, features, quick start
  2. docs/guide/architecture.md - Internal design, module structure, request flow
  3. docs/guide/configuration.md - Service and handler configuration
  4. docs/guide/examples.md - Code examples and usage patterns
  5. Other topic-specific guides in docs/guide/ (compression, timeouts, tonic integration, etc.)
  6. Codebase search for implementation details