Skip to content
Skills Library
AI & agents · Writing

issue-reporting

/issue-reporting

Helps users report issues with GTM skills — incorrect advice, broken activation, missing context, or unexpected behavior. Guides through gathering the right details (skill name, prompt used, actual vs expected output, context files present) and generates a properly formatted GitHub issue. Use when users say: 'this skill gave wrong advice', 'report a bug', 'file an issue', 'skill isn't working', 'wrong output', 'skill didn't activate', 'bad recommendation', 'incorrect behavior', or 'something is broken'.

Licence
MIT
Last repository change
18.09.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
2
Deprecation

No signals detected. Repository changed on 18.09.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Helps users report issues with GTM skills — incorrect advice, broken activation, missing context, or unexpected behavior. Guides through gathering the right details (skill name, prompt used, actual vs expected output, context files present) and generates a properly formatted GitHub issue. Use when users say: 'this skill gave wrong advice', 'report a bug', 'file an issue', 'skill isn't working', 'wrong output', 'skill didn't activate', 'bad recommendation', 'incorrect behavior', or 'something is broken'.

Triggers from the description

this skill gave wrong advicereport a bugfile an issueskill isnwrong outputskill didnbad recommendationincorrect behavior
Original author description

Helps users report issues with GTM skills — incorrect advice, broken activation, missing context, or unexpected behavior. Guides through gathering the right details (skill name, prompt used, actual vs expected output, context files present) and generates a properly formatted GitHub issue. Use when users say: 'this skill gave wrong advice', 'report a bug', 'file an issue', 'skill isn't working', 'wrong output', 'skill didn't activate', 'bad recommendation', 'incorrect behavior', or 'something is broken'.

How it works

  1. Workspace Context
  2. Operating Contract
  3. When This Skill Activates
  4. Step 1 — Identify the Problem
  5. Step 2 — Gather Context
  6. Step 3 — Classify the Issue
  7. Step 4 — Generate the Issue
  8. Step 5 — Offer Next Steps
  9. Important
Original SKILL.md headings · 127 lines, 746 words
SKILL.md preview
---
name: issue-reporting
description: "Helps users report issues with GTM skills — incorrect advice, broken activation, missing context, or unexpected behavior. Guides through gathering the right details (skill name, prompt used, actual vs expected output, context files present) and generates a properly formatted GitHub issue. Use when users say: 'this skill gave wrong advice', 'report a bug', 'file an issue', 'skill isn't working', 'wrong output', 'skill didn't activate', 'bad recommendation', 'incorrect behavior', or 'something is broken'."
---

# Issue Reporting

## Workspace Context

Read bootstrap context before asking questions: `strategy/brand.md` for brand, audience, offer, channels, tools, constraints, and metrics; `about/me.md` for personal voice; `content/ideas.md` and `content/calendar.md` for content planning. Use legacy product-marketing context files only as fallback. Save generated drafts to `content/<platform>/drafts/YYYY-MM-DD_short-topic-slug.md`, and route durable learnings back to `strategy/brand.md`, `about/me.md`, or `content/ideas.md`.

## Operating Contract

This skill is self-contained for its frontmatter scope: use its local instructions, references, scripts, and assets as the playbook; ask only for missing task-specific inputs; hand off to adjacent skills instead of expanding scope; and return an actionable artifact, decision, plan, draft, or diagnostic.



Help users report problems with GTM skills clearly and completely so maintainers can fix them fast.

## When This Skill Activates

- User says a skill gave wrong or harmful advice
- User says a skill isn't activating when it should
- User says their brand context wasn't applied
- User says output format is wrong or unexpected
- User wants to report a bug or file an issue
- User says "something is broken" about a skill

## Step 1 — Identify the Problem

Ask the user what went wrong. Determine:

1. **Which skill** — get the exact skill name (e.g. `seo-and-aeo-strategy`, `copywriting-core`)
2. **What they asked** — the exact prompt or task they gave Claude
3. **What happened** — the actual output or behavior
4. **What they expected** — what should have happened instead

If the user is vague ("it gave bad advice"), ask specifically what was incorrect and why.

## Step 2 — Gather Context

Check the user's project for context that helps diagnose the issue:

### Context files

Check if these exist and note their presence:

- `strategy/brand.md` — brand positioning, messaging, audience
- `about/me.md` — personal voice, writing style
- `CLAUDE.md` — AI instructions

Missing context files are the **most common cause** of "wrong advice" bugs. If `strategy/brand.md` or `about/me.md` are missing, tell the user:

> "The skill may have given generic advice because your brand context files are missing. Run `/bootstrap` to set them up. If the skill still gives wrong advice after that, then it's a real bug worth reporting."

### Plugin version

Check `.claude-plugin/plugin.json` for the current version number.

### Installation method

Ask how they installed the plugin (Claude Code, Cowork, Skills CLI, git clone, submodule).

## Step 3 — Classify the Issue

Categorize into one of these types:

| Type | Description | Common cause |
|---|---|---|
| Wrong advice | Skill produced incorrect or harmful recommendations | Outdated framework, wrong domain assumptions |
| Not activating | Skill should have triggered but didn't | Description mismatch, trigger phrase gap |
| Wrong activation | Skill triggered when it shouldn't have | Overly broad description |
| Missing context | Brand/voice not applied to output | Context files missing or not read |
| Bad format | Output structure is wrong | Skill template issue |
| Crash/error | Skill fails mid-execution | Syntax error in skill, bad reference path |

## Step 4 — Generate the Issue

Compose a GitHub issue using the bug report template. Format it so the user can copy-paste or click through:

**Direct link** (pre-fills the template):

```
https://github.com/manojbajaj95/claude-gtm-plugin/issues/new?template=bug_report.yml
```

**Formatted issue body** (if they prefer to paste manually):

```markdown
**Skill**: [skill-name]
**Type**: [category from Step 3]
**Plugin Version**: [version]
**Installation**: [method]

### What I asked
[exact prompt]

### What happened
[actual output — include relevant excerpt]

### What I expected
[expected behavior]

### Context files present
- [ ] strategy/brand.md
- [ ] about/me.md
- [ ] CLAUDE.md

### Steps to reproduce
1. [step-by-step if applicable]

### Impact
[Critical / High / Medium / Low]
```

## Step 5 — Offer Next Steps

After generating the issue:

1. Give them the direct link to file it: `https://github.com/manojbajaj95/claude-gtm-plugin/issues/new?template=bug_report.yml`
2. If the problem is missing context files, suggest running `/bootstrap` first
3. If it's clearly a skill bug, encourage them to file it — it helps improve the plugin for everyone
4. Thank them for reporting — contributors who file clear issues are invaluable

## Important

- Never dismiss user frustration — if they think the advice is wrong, take it seriously
- Don't try to fix the skill yourself — this skill is for *reporting*, not patching
- Be specific in the issue — vague reports like "it didn't work" are hard to act on
- Include the actual output when possible — maintainers need to see what went wrong

Versions

The database has no other skills named issue-reporting.

Database snapshot: 13.11.2026 · package version b3c12e80a4ca (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100agent-bad-response-triage-and-root-cause-classification
    Guides triaging a single reported bad, wrong, or harmful agent response: reproducing it deterministically and classifying the root cause into one of five buckets — prompt issue, tool failure, retrieval issue, model behavior change, or genuine edge case — so the fix targets the…
  • 100feedback
    Collect user feedback about the Agentic Meta Project and file it. Use when the user says "feedback", "report a bug", "file an issue", or wants to report friction, suggestions, or feature requests. Files as a GitHub issue if gh CLI is available, otherwise writes a local report.
  • 100prompt-validation
    Evaluates and scores Claude prompts and system prompts using a six-dimension Scorecard with anchored 1-5 rubrics. Trigger on: "review my prompt," "score this prompt," "rate my prompt," "evaluate this prompt," "improve my prompt," "what's wrong with my prompt." Also trigger on:…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.