create-known-issues

Generate a structured known-issues document with status and tracking modes.

Updated Feb 10, 2026
One-click install
npx skills add https://github.com/jrodrigopuca/skills --skill create-known-issues
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-known-issues
Source: https://github.com/jrodrigopuca/skills/tree/main/create-software-docs/sub-skills/create-known-issues
Command: npx skills add https://github.com/jrodrigopuca/skills --skill create-known-issues

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill consolidates and documents known issues, limitations, and accepted trade-offs within a project, ensuring visibility and preventing loss of critical context.

Core Features & Use Cases

  • Issue Consolidation: Merges findings from validation, cleanup, and manual reviews into a single source of truth.
  • Status Tracking: Maintains clear statuses for each issue (e.g., open, accepted, resolved).
  • Use Case: After a code audit, use this Skill to generate a known-issues.md file that lists all identified bugs, accepted limitations, and areas needing future clarification, categorized by severity and status.

Quick Start

Generate a known issues document for the 'api-gateway' scope using compact tracking mode.

Frequently Asked Questions about create-known-issues

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document known issues and accepted trade-offs after a code audit?

Documenting known issues after a code audit requires consolidating validation, cleanup, and repository evidence into a structured file. This process merges findings into a single source of truth, preserving issue status and historical context for future reference.

What is the best way to track known limitations in a software project?

The best way to track known limitations is using a structured document that supports compact and full tracking modes. This maintains clear statuses like open, accepted, or resolved for each issue, ensuring visibility and preventing loss of critical project context.

How do I generate a known-issues.md file for a specific project scope?

Generating a known-issues document for a specific scope requires defining the target path, tracking mode, and providing validation findings. The output is a Document Generation Artifact detailing sources inspected, confidence notes, and open questions for comprehensive issue tracking.

Can I consolidate validation and cleanup findings into a single issue tracking document?

Yes, you can consolidate validation and cleanup findings into a single issue tracking document. This merges manual reviews and automated findings into one source of truth, maintaining clear statuses and preventing the loss of critical context across the project.

What information do I need to provide to document accepted technical trade-offs?

Documenting accepted technical trade-offs requires a defined project scope, validation and cleanup findings, and repository evidence. This generates a document preserving issue status, historical context, and categorizing limitations by severity for clear visibility.

What is the difference between compact and full tracking modes for issue documentation?

The difference between compact and full tracking modes lies in the depth of issue documentation. Both modes generate a structured artifact with target paths, sources inspected, confidence notes, and open questions, but allow scaling the tracking detail to fit project needs.