AugmentClaude

Feedback Intake

File bug reports and feature requests for Nimbalyst to GitHub Issues.

Installation

  1. Make sure Claude is on your device and in your terminal.

    Skills load from ~/.claude/skills/ when Claude Code starts up — so you need it on your machine first. If you don't have it yet, install it once with the command below, then run claude in any terminal to verify.

    One-time setup
    npm i -g @anthropic-ai/claude-code

    Already have it? Skip ahead.

  2. Paste into Claude Code or into your terminal.

    This copies the whole skill folder into ~/.claude/skills/feedback-intake-nimbalyst/ — the SKILL.md plus any scripts, reference docs, or templates the skill ships with. Safe default: works for every skill.

    Faster alternative (instruction-only skills)

    Skips the clone and grabs only the SKILL.md file. Don't use this if the skill ships Python scripts, reference markdowns, or asset templates — they won't be downloaded and the skill will fail when it tries to load them.

    Quick install (SKILL.md only)
    Sign up to copy
  3. Restart Claude Code.

    Quit and reopen Claude Code (or any other agent that loads from ~/.claude/skills/). New skills are picked up on startup.

  4. Just ask Claude.

    Skills auto-activate when your request matches the skill's description — no slash command needed. Trigger phrases live in the skill's own frontmatter; you can read them in the “What this skill does” section above.

Prefer to read the source first? Open on GitHub.

When Claude uses it

Help the user file a bug report or feature request for Nimbalyst. Activates when the user opens the in-app feedback flow or runs /feedback:bug-report or /feedback:feature-request. Coordinates evidence gathering, anonymization, and posting to GitHub Issues.

What this skill does

Nimbalyst Feedback Skill

This skill is the entry point for the Nimbalyst in-app feedback flow. It activates when:

  • The user runs the /feedback:bug-report slash command
  • The user runs the /feedback:feature-request slash command
  • The user opens a session with sessionType: 'bug-report' or sessionType: 'feature-request'

Behavior

Read the matching command file:

  • For bug reports: commands/bug-report.md in this plugin
  • For feature requests: commands/feature-request.md in this plugin

Both commands share these constraints:

  1. The user is the gate. Never call mcp__nimbalyst-situational__feedback_open_github_issue without explicit user approval of the final title and body.
  2. Anonymize aggressively. Run anything that includes file paths, log content, environment strings, or workspace identifiers through mcp__nimbalyst-situational__feedback_anonymize_text first, then read the output and redact anything else that looks sensitive.
  3. Honor the intake flags. Bug-report sessions include Log gathering: allowed or Log gathering: not allowed; feature-request sessions may include UX mockup: requested or UX mockup: not requested. Only bug reports may read logs, and only when log gathering is allowed.
  4. Handle long reports. When the drafted body exceeds the URL safe length, the URL builder returns reason: 'too-long'. Fall back to: show the body in chat, open a no-body URL, tell the user to paste.
  5. Target repo and templates. Bug reports use bug_report.yml; feature requests use feature_request.yml. Both target nimbalyst/nimbalyst. Don't hardcode the URL — let the URL builder handle template selection and field-id routing. The GitHub issue type (Bug / Feature) and status:needs-triage label come from the template frontmatter, not from the URL builder.

Tools available

  • mcp__nimbalyst-situational__feedback_anonymize_text(text) → returns anonymized string
  • mcp__nimbalyst-situational__feedback_get_environment() → app version, OS, recent error counts
  • mcp__nimbalyst-situational__feedback_open_github_issue({ kind, title, body }) → opens GitHub new-issue page in browser, returns { ok, opened, reason?, url? }
  • mcp__nimbalyst-extension-dev__get_main_process_logs({ lastLines, searchTerm, logLevel, component }) → only with consent
  • mcp__nimbalyst-extension-dev__get_renderer_debug_logs({ lastLines, searchTerm, logLevel }) → only with consent

Important

  • Don't add "generated by AI" or "Co-Authored-By" lines to the issue body.
  • Don't claim the issue was submitted; the user clicks Submit on github.com themselves.
  • If the user pivots from a bug to a feature mid-conversation (or vice versa), say so and switch templates.

Related skills