neolabhq/context-engineering-kit1 file

Analyze Issue

Analyze a GitHub issue and create a detailed technical specification

Specification
Skill ID
neolabhq/context-engineering-kit/analyze-issue
Publisher
neolabhq
Repository
context-engineering-kit
Installs
0
Files
1
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

neolabhq/context-engineering-kit/analyze-issueInstalls these files
  • SKILL.md

What this skill tells the agent

Please analyze GitHub issue #$ARGUMENTS and create a technical specification.

Follow these steps:

  1. Check if the issue is already loaded:
  • Look for the issue file in ./specs/issues/ folder
  • File naming pattern: <number-padded-to-3-digits>-<kebab-case-title>.md
  • If not found, fetch the issue details from GitHub (see step 2)
  1. Fetch the issue details (if not already loaded):
  • Read .claude/commands/load-issues.md to understand how to fetch issue details
  • Save the issue file following the load-issues.md format
  1. Understand the requirements thoroughly
  2. Review related code and project structure
  3. Create a technical specification with the format below

Technical Specification for Issue #$ARGUMENTS

Issue Summary

  • Title: [Issue title from GitHub]
  • Description: [Brief description from issue]
  • Labels: [Labels from issue]
  • Priority: [High/Medium/Low based on issue content]

Problem Statement

[1-2 paragraphs explaining the problem]

Technical Approach

[Detailed technical approach]

Implementation Plan

  1. [Step 1]
  2. [Step 2]
  3. [Step 3]

Test Plan

  1. Unit Tests:
  • [test scenario]
  1. Component Tests:
  • [test scenario]
  1. Integration Tests:
  • [test scenario]

Files to Modify

  • [file path]: [changes]

Files to Create

  • [file path]: [purpose]

Existing Utilities to Leverage

  • [utility name/path]: [purpose]

Success Criteria

  • [ ] [criterion 1]
  • [ ] [criterion 2]

Out of Scope

  • [item 1]
  • [item 2]

Remember to follow our strict TDD principles, KISS approach, and 300-line file limit.

IMPORTANT: After completing your analysis, SAVE the full technical specification to: ./specs/issues/<number-padded-to-3-digits>-<kebab-case-title>.specs.md

For example, for issue #7 with title "Make code review trigger on any *.SQL and .sh file changes", save to: ./specs/issues/007-make-code-review-trigger-on-sql-sh-changes.specs.md

After saving, provide a brief summary to the user confirming:

  • Issue number and title analyzed
  • File path where the specification was saved
  • Key highlights from the specification (2-3 bullet points)

Use this skill in a project

Open any RiverX project, search the Skills panel for neolabhq/context-engineering-kit/analyze-issue, and install it in one click.

Use this skill