Imported from mrsixw/jeeves (.agents/skills/raise-issue/SKILL.md). Install upstream with npx skills add mrsixw/jeeves --skill raise-issue. Copyright stays with the author.

Raise Issue Skill

Name: raise-issue
Author: mrsixw

Standardized procedure to generate and raise a high-quality issue on GitHub for this project.

When to use this skill

Use this skill when you identify a bug, a required enhancement, or a new feature that does not have an active GitHub issue yet.
A GitHub issue MUST exist before any coding work begins. Always use this skill first.

How to use it

Steps

Analyze the problem or requirement:
- For bugs: exact error tracebacks, terminal output, reproduction commands, and conditions.
- For features: proposed goals, user benefit, CLI flags or API methods, and expected output.

Generate a structured description:

Bug Issues:

## Problem
[What is failing and why it is wrong. Include tracebacks.]

## Steps to reproduce
\`\`\`bash
[Exact command to trigger the bug]
\`\`\`

## Expected behaviour
[What should happen.]

## Actual behaviour
[What is currently happening.]

## Suspected Cause (optional)
[Specific file, function, or commit suspected.]

Feature / Enhancement Issues:

## Summary
[High-level explanation of the feature and what user problem it solves.]

## Proposed Solution
[How it should be implemented — CLI subcommands, API methods, config keys.]

## Examples
\`\`\`bash
jeeves whoami
👤 Authenticated as: alice (Alice Smith)
\`\`\`

## Acceptance Criteria
- [ ] [Behaviour under condition A]
- [ ] [Error handling for condition B]
- [ ] [Tests added]
- [ ] [make format && make lint && make test all pass]

Verify the title:
- Keep it imperative and natural. No conventional commit prefixes (feat:, fix:).
- Example: "Add whoami command for auth/connectivity debugging"

Create the issue:

gh issue create --repo mrsixw/jeeves --title "<title>" --body "<body>"

Confirm to the user: Report the issue URL and number.

{ "ocm": "1", "id": "mrsixw-jeeves-raise-issue", "kind": "skill", "name": "raise-issue", "description": "Raise a detailed, structured issue on GitHub. Gathers context, builds reproduction steps, expected outcomes, and acceptance criteria.", "publisher": "mrsixw", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Raise a detailed, structured issue on GitHub. Gathers context, builds reproduction steps, expected outcomes, and acceptance criteria." ], "primary": false, "metadata": { "source": { "provider": "github", "repository": "https://github.com/mrsixw/jeeves", "path": ".agents/skills/raise-issue/SKILL.md", "ref": "2a3f50d57e8fa07718f66fd7cdd3e165ec6d55ec", "url": "https://github.com/mrsixw/jeeves/blob/2a3f50d57e8fa07718f66fd7cdd3e165ec6d55ec/.agents/skills/raise-issue/SKILL.md", "key": "mrsixw/jeeves/.agents/skills/raise-issue/SKILL.md" } }, "instructions": "# Raise Issue Skill\n\nStandardized procedure to generate and raise a high-quality issue on GitHub for this project.\n\n## When to use this skill\n- Use this skill when you identify a bug, a required enhancement, or a new feature that does not have an active GitHub issue yet.\n- **A GitHub issue MUST exist before any coding work begins.** Always use this skill first.\n\n## How to use it\n\n### Steps\n\n1. **Analyze the problem or requirement:**\n - For bugs: exact error tracebacks, terminal output, reproduction commands, and conditions.\n - For features: proposed goals, user benefit, CLI flags or API me", "cost": { "context_tokens": 494 } }

raise-issue

About

Raise Issue Skill

When to use this skill

How to use it

Steps

Bug Issues:

Feature / Enhancement Issues:

Use it

Manifest

Reviews