skills.rest
open-mercato
open-mercatoOFFICIAL
Explore all skills by this author →
WebsiteGitHub

om-prepare-issue

Prepares spec-driven issue drafts with enterprise scope and duplicate-spec checks for Open Mercato.

1.7k|382|Updated Sep 10, 2025
Search Tags:#duplicate detection#AI Workflow#ticketing#spec-Driven Development#Open Mercato#enterprise scope#issue preparation
One-click install
npx skills add https://github.com/open-mercato/open-mercato --skill om-prepare-issue
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: om-prepare-issue
Source: https://github.com/open-mercato/open-mercato/tree/main/.ai/skills/om-prepare-issue
Command: npx skills add https://github.com/open-mercato/open-mercato --skill om-prepare-issue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams working in the Open Mercato repository risk writing duplicate or misplaced specs when preparing issues, and they lack a consistent path from a spec to its implementation. This Skill extends the shared om-prepare-issue workflow with repo-specific rules so every prepared issue lands in the right spec tree and carries a clear pickup path.

Core Features & Use Cases

  • Enterprise spec scope: The optional --enterprise argument writes the spec under .ai/specs/enterprise/ instead of the default .ai/specs/ and adds the enterprise category label to the spec PR.
  • Duplicate-spec detection: Before writing, it checks both .ai/specs/ and .ai/specs/enterprise/ for existing specs covering the same area, and scans .ai/lessons.md for matching lesson records by module, area, or topic tags.
  • Spec methodology enforcement: Applies the repo-local om-spec-writing skill in full, including the compliance-review gate and the OM spec template.
  • Use Case: A developer wants to spec a new CRM feature. The Skill checks both spec trees for overlap, writes the spec using the OM template, and records that /om-implement-spec will pick it up once the spec PR merges into develop.

Quick Start

Ask the assistant to prepare an issue for a new feature in the Open Mercato repo, optionally passing --enterprise to place the spec in the commercial scope.

Frequently Asked Questions about om-prepare-issue

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

FAQPage Schema
How do I prepare a spec-driven issue in the Open Mercato repo?▼

Invoke the om-prepare-issue workflow, which follows the shared skill from open-mercato/skills plus repo-local rules. It checks for duplicate specs, applies the OM spec template, and records the pickup path for implementation after the spec PR merges into develop.

How do I write a spec in the enterprise scope?▼

Pass the --enterprise argument when preparing the issue. The spec is then written under .ai/specs/enterprise/ instead of the default .ai/specs/, and the resulting spec PR also carries the enterprise category label.

Does the skill check for duplicate specs before writing?▼

Yes. Before writing, it checks both .ai/specs/ and .ai/specs/enterprise/ for an existing spec covering the same area, and prefers extending or superseding it after confirming direction with the user. It also scans .ai/lessons.md for matching lesson records.

What happens after the spec PR is merged?▼

The tracking issue states the pickup path: /om-implement-spec for the spec implementation, or /om-auto-fix-issue for a scoped bug. These become actionable only after the spec PR is merged into the develop branch.

Which spec methodology does this skill enforce?▼

It applies the repo-local om-spec-writing skill in full, including the compliance-review gate and the OM spec template, so every prepared spec follows the same structure and review standard.

Related Skills

Explore More Software Engineering Skills→
calcosmiccalcosmic
9

phase-context-gathering

Scan codebases to produce structured CONTEXT.md with gray-area severities.

Community
Intermediate
SHGrowthSHGrowth
6

om-cto

Analyze platform gaps and orchestrate spec writing for Open Mercato.

Official
Advanced
HaamiahphpHaamiahphp

spec-driven-implementation

Create and maintain PRODUCT.md and TECH.md specs under specs/<ticket-number>/ before implementation.

Community
Intermediate
sampaio-techsampaio-tech
19

theme-system

Manage iOS design system themes with 8 color palettes and 22 typography styles for Flutter.

Official
Intermediate