# Draft and Publish Clear GitHub Issues

Unclear issue requests create rework, duplicates, and weak acceptance criteria. This skill produces reviewed GitHub issues with consistent structure and controlled publishing.

## Install

```bash
npx skillstore add equinor/fusion-issue-authoring
```

## Metadata

- Status: approved
- Slug: equinor-fusion-issue-authoring
- Version: 0.3.5
- Author version: 0.3.5
- Skillstore revision: r1
- Version status: valid
- Tree hash: ad8f522cf3ca7d258007b0d470a1eb2a0ae1de2eb87fa3ced3b791bc0fa8c7ff
- Author: equinor
- GitHub username: equinor
- License: MIT
- Repository: https://github.com/equinor/fusion-skills/tree/8ae37cccd02414337f0efbad174f20ce50027523/skills/fusion-issue-authoring
- Ref: 7562931ce7d490305c630ba8341f38a5e060bcd8
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: network, external\_commands, env\_access
- Quality score: 81
- Quality tier: silver
- Public page: https://skillstore.pages.dev/skills/equinor-fusion-issue-authoring
- Manifest: https://skillstore.pages.dev/api/skills/equinor-fusion-issue-authoring/manifest

## Capabilities

- Classifies requests as bugs, features, user stories, or tasks.
- Uses repository issue templates before bundled fallback templates.
- Runs one focused duplicate search and surfaces matching issues.
- Drafts issue content, labels, assignees, types, and dependency plans.
- Creates or updates GitHub issues only after explicit user confirmation.
- Adds, removes, and reprioritizes sub-issues when requested.

## Use Cases

- Shape a feature request: Convert a product idea into scoped outcomes, acceptance criteria, labels, and a reviewable GitHub issue.
- Report a reproducible bug: Organize symptoms, reproduction steps, environment details, severity, and expected behavior before publishing.
- Plan linked delivery tasks: Decompose work into ordered tasks, identify blockers, and prepare parent and sub-issue relationships.

## Prompt Templates

### Draft a basic issue

```
Draft a GitHub issue for [idea]. Use repository [owner/repo], ask for missing details, and wait for approval before publishing.
```

### Prepare a bug report

```
Create a bug issue for [problem] in [owner/repo]. Capture reproduction steps, environment, impact, expected behavior, and possible duplicates.
```

### Build a user story

```
Draft a user story for [user need]. Define role, workflow, scenarios, acceptance criteria, boundaries, dependencies, labels, and assignee intent.
```

### Plan and link tasks

```
Stress-test [objective], then decompose it into ordered GitHub tasks. Identify unresolved contracts, blockers, issue types, and proposed sub-issue links.
```

## Limitations

- Requires a target repository and enough issue context before publishing.
- GitHub mutations require a configured MCP server, authentication, and repository permissions.
- Does not implement code changes or author pull requests.
- Cannot publish the first draft without explicit user confirmation.

## Best Practices

- Provide the target repository, desired outcome, and important constraints.
- Review title, body, labels, assignee, issue type, and relationships before approval.
- Resolve architecture assumptions before creating parallel implementation tasks.

## Anti Patterns

- Do not request publication before reviewing the generated draft.
- Do not use vague acceptance criteria that cannot be verified.
- Do not create contradictory or circular issue relationships.

## Security Audit

- Audited at: 2026-08-26T08:36:29.747\+00:00
- Summary: All 79 static alerts are false positives caused by Markdown formatting, GraphQL fields, release notes, and GitHub documentation. The skill gates GitHub mutations behind explicit approval and shows no prompt injection, credential access, or malicious intent.

## Stats

- Views: 0
- Downloads: 0
- Favorites: 0
- Popularity score: 0