om-prepare-issue

Creates deduplicated, spec-linked tracker issues with SDLC labels from free-form briefs.

1|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/tkogut/agents-os-core --skill om-prepare-issue-tkogut
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: om-prepare-issue
Source: https://github.com/tkogut/agents-os-core/tree/main/global_skills/om-prepare-issue
Command: npx skills add https://github.com/tkogut/agents-os-core --skill om-prepare-issue-tkogut

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning a rough idea or bug report into a well-formed, actionable tracker issue is tedious and error-prone: duplicates pile up, specs go unlinked, labels are inconsistent, and future implementers get vague tickets they cannot pick up cold. This Skill converts a free-form brief into a single ready-to-implement issue without writing any code. ## Core Features & Use Cases - Duplicate Detection: Searches open issues and PRs semantically before filing, reusing or commenting on existing items instead of creating near-copies. - Spec Linking and Authoring: Links a covering spec when one exists, or delegates to a spec-writing workflow that lands a design-only spec PR for substantial features. - SDLC Labeling and Evidence: Applies category, priority, and risk labels with a documented rationale, and attaches user-provided screenshots as issue evidence. - Use Case: A product manager says "file an issue for adding dark mode to the settings page." The Skill checks for duplicates, finds no covering spec, authors one on a design-only PR, and files a labeled issue with step-by-step implementation guidance a future run can execute cold. ## Quick Start Ask the agent to file an issue for your idea, for example: "File an issue for adding CSV export to the reports dashboard, priority high."

Frequently Asked Questions about om-prepare-issue

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

FAQPage Schema
How do I file a GitHub issue from a short feature brief?▼

Provide a free-form brief describing the feature or fix. The Skill searches for duplicates, links or authors a covering spec, writes a structured issue body with implementation steps, and applies SDLC labels on creation.

How does the issue creation avoid duplicates?▼

It runs multiple search queries against open issues and PRs using key nouns and verbs from the brief, then judges top candidates semantically. Credible duplicates are reused with a comment instead of filing a copy.

Can it attach screenshots to a new issue?▼

Yes, pasted screenshots or image file paths are uploaded via the tracker's attach-image-evidence operation and embedded in an Evidence section. If upload is unavailable, it references local paths without failing issue creation.

Does it write code or only create the issue?▼

It only mutates tracker state: one issue, optional comments, and on the spec path a design-only spec PR. It never edits repository source files; implementation is handed off to separate fix or implement skills.

When should I use issue management instead of issue creation?▼

Use creation only for new issues. To enrich, relabel, or clarify an issue that already exists, hand off to the issue-management skill, which handles single issues or filtered batches.