gspec 1.18.0 → 1.19.0

package/README.md

@@ -165,7 +165,7 @@ The CLI will ask which platform you're installing for:
 | Cursor | `.cursor/commands/` |
 | Antigravity | `.agent/skills/` |
 | Codex | `.agents/skills/` |
-| Open Code | `.opencode/skills/` |
+| Open Code | `.opencode/commands/` + `.opencode/skills/` |
 
 You can skip the prompt by passing a target directly:
 
@@ -257,7 +257,7 @@ Most specs are Markdown. The style guide can also be a self-contained HTML file
 | [Cursor](https://www.cursor.com/) | Commands format | Supported |
 | [Antigravity](https://www.antigravity.dev/) | Skills format | Supported |
 | [Codex](https://developers.openai.com/codex/cli/) | Skills format | Supported |
-| [Open Code](https://opencode.ai/) | Skills format | Supported |
+| [Open Code](https://opencode.ai/) | Commands + skills | Supported |
 
 ## Project Status
 

package/bin/emitters.js

@@ -4,10 +4,25 @@ import { join } from 'node:path';
 // Placeholder pattern used in generic command files
 export const PLACEHOLDER_RE = /<<<\w+>>>/g;
 
+// Emit a YAML scalar safely. Skill descriptions contain ": ", embedded "…"
+// examples, and other characters that break unquoted plain scalars, so every
+// value goes out as a double-quoted scalar with the minimal escape set
+// required by the YAML 1.2 spec (backslash, double-quote, and control chars).
+function yamlScalar(value) {
+  const str = String(value);
+  const escaped = str
+    .replace(/\\/g, '\\\\')
+    .replace(/"/g, '\\"')
+    .replace(/\r/g, '\\r')
+    .replace(/\n/g, '\\n')
+    .replace(/\t/g, '\\t');
+  return `"${escaped}"`;
+}
+
 export function buildFrontmatter(fields) {
   const lines = ['---'];
   for (const [key, value] of Object.entries(fields)) {
-    lines.push(`${key}: ${value}`);
+    lines.push(`${key}: ${yamlScalar(value)}`);
   }
   lines.push('---');
   return lines.join('\n');
@@ -39,6 +54,7 @@ export const TARGETS = {
     distSubdir: 'cursor',
     installDir: '.cursor/commands',
     layout: 'flat',
+    fileExt: '.mdc',
     // .cursor/commands/<name>.mdc (flat file)
     async emit(outDir, content, meta) {
       const frontmatter = buildFrontmatter({
@@ -87,18 +103,35 @@ export const TARGETS = {
   opencode: {
     label: 'Open Code',
     distSubdir: 'opencode',
-    installDir: '.opencode/skills',
-    layout: 'directory',
-    // .opencode/skills/<name>/SKILL.md
+    installDir: '.opencode',
+    layout: 'dual',
+    fileExt: '.md',
+    // Dual emission — opencode splits Claude Code's skill behavior across two
+    // mechanisms, so each prompt ships twice:
+    //   .opencode/commands/<name>.md    slash command the user invokes (/gspec-*)
+    //   .opencode/skills/<name>/SKILL.md skill the agent auto-loads by description
+    // On a name collision opencode's slash menu prefers the file command, so
+    // both can coexist safely.
     async emit(outDir, content, meta) {
-      const frontmatter = buildFrontmatter({
+      // opencode commands support $ARGUMENTS substitution, same as Claude Code
+      const commandFrontmatter = buildFrontmatter({
+        description: meta.description,
+      });
+      const commandBody = content.replace(PLACEHOLDER_RE, '$ARGUMENTS');
+      const commandsDir = join(outDir, 'commands');
+      await mkdir(commandsDir, { recursive: true });
+      await writeFile(join(commandsDir, `${meta.name}.md`), commandFrontmatter + '\n\n' + commandBody, 'utf-8');
+
+      // Skill content is loaded as context, not expanded as a template, so
+      // strip the placeholder lines rather than mapping them to $ARGUMENTS
+      const skillFrontmatter = buildFrontmatter({
         name: meta.name,
         description: meta.description,
       });
-      const body = content.replace(/^.*<<<\w+>>>.*$\n?/gm, '');
-      const skillDir = join(outDir, meta.name);
+      const skillBody = content.replace(/^.*<<<\w+>>>.*$\n?/gm, '');
+      const skillDir = join(outDir, 'skills', meta.name);
       await mkdir(skillDir, { recursive: true });
-      await writeFile(join(skillDir, 'SKILL.md'), frontmatter + '\n\n' + body, 'utf-8');
+      await writeFile(join(skillDir, 'SKILL.md'), skillFrontmatter + '\n\n' + skillBody, 'utf-8');
     },
   },
 };

package/bin/gspec.js

@@ -353,7 +353,7 @@ async function findExistingFiles(target, cwd) {
 
   if (target.layout === 'flat') {
     const srcEntries = await readdir(target.sourceDir);
-    for (const file of srcEntries.filter(f => f.endsWith('.mdc'))) {
+    for (const file of srcEntries.filter(f => f.endsWith(target.fileExt))) {
       try {
         await stat(join(destBase, file));
         existing.push(file);
@@ -361,6 +361,27 @@ async function findExistingFiles(target, cwd) {
         if (e.code !== 'ENOENT') throw e;
       }
     }
+  } else if (target.layout === 'dual') {
+    const commandFiles = await readdir(join(target.sourceDir, 'commands'));
+    for (const file of commandFiles.filter(f => f.endsWith(target.fileExt))) {
+      try {
+        await stat(join(destBase, 'commands', file));
+        existing.push(`commands/${file}`);
+      } catch (e) {
+        if (e.code !== 'ENOENT') throw e;
+      }
+    }
+    const skillEntries = await readdir(join(target.sourceDir, 'skills'));
+    for (const entry of skillEntries) {
+      const info = await stat(join(target.sourceDir, 'skills', entry));
+      if (!info.isDirectory()) continue;
+      try {
+        await stat(join(destBase, 'skills', entry, 'SKILL.md'));
+        existing.push(`skills/${entry}/SKILL.md`);
+      } catch (e) {
+        if (e.code !== 'ENOENT') throw e;
+      }
+    }
   } else {
     const srcEntries = await readdir(target.sourceDir);
     for (const entry of srcEntries) {
@@ -398,16 +419,44 @@ async function installDirectory(target, cwd) {
   return skills.length;
 }
 
+async function installDual(target, cwd) {
+  const commandsSrc = join(target.sourceDir, 'commands');
+  const commandsDest = join(cwd, target.installDir, 'commands');
+  await mkdir(commandsDest, { recursive: true });
+  const commandFiles = (await readdir(commandsSrc)).filter(f => f.endsWith(target.fileExt));
+  for (const file of commandFiles) {
+    const content = await readFile(join(commandsSrc, file), 'utf-8');
+    await writeFile(join(commandsDest, file), content, 'utf-8');
+  }
+
+  const skillsSrc = join(target.sourceDir, 'skills');
+  const entries = await readdir(skillsSrc);
+  const skills = [];
+  for (const entry of entries) {
+    const info = await stat(join(skillsSrc, entry));
+    if (info.isDirectory()) skills.push(entry);
+  }
+  for (const skill of skills) {
+    const destDir = join(cwd, target.installDir, 'skills', skill);
+    await mkdir(destDir, { recursive: true });
+    const content = await readFile(join(skillsSrc, skill, 'SKILL.md'), 'utf-8');
+    await writeFile(join(destDir, 'SKILL.md'), content, 'utf-8');
+    console.log(`  ${chalk.green('+')} ${skill} ${chalk.dim('(command + skill)')}`);
+  }
+
+  return skills.length;
+}
+
 async function installFlat(target, cwd) {
   const entries = await readdir(target.sourceDir);
-  const files = entries.filter(f => f.endsWith('.mdc'));
+  const files = entries.filter(f => f.endsWith(target.fileExt));
   const destDir = join(cwd, target.installDir);
   await mkdir(destDir, { recursive: true });
 
   for (const file of files) {
     const content = await readFile(join(target.sourceDir, file), 'utf-8');
     await writeFile(join(destDir, file), content, 'utf-8');
-    const name = file.replace(/\.mdc$/, '');
+    const name = file.slice(0, -target.fileExt.length);
     console.log(`  ${chalk.green('+')} ${name}`);
   }
 
@@ -454,7 +503,9 @@ async function install(targetName, cwd) {
 
   const count = target.layout === 'flat'
     ? await installFlat(target, cwd)
-    : await installDirectory(target, cwd);
+    : target.layout === 'dual'
+      ? await installDual(target, cwd)
+      : await installDirectory(target, cwd);
 
   console.log(chalk.bold(`\n${count} skills installed to ${target.installDir}/\n`));
 

package/commands/gspec.profile.md

@@ -31,7 +31,6 @@ You should:
   - The product type is ambiguous
   - The target audience or user is unclear
   - The core value proposition is ambiguous
-  - *(Commercial products only)* The business model or monetization strategy is unspecified
   - *(Commercial products only)* Competitive positioning is unknown
 - **When asking questions**, offer 2-3 specific suggestions to guide the discussion
 - Write for the audience the product actually has (internal stakeholders, end users, contributors, the public, etc.)
@@ -39,6 +38,7 @@ You should:
 - Focus on the "what" and "why", not the "how"
 - Use clear, jargon-free language where possible
 - **Mark sections as "Not Applicable"** when they don't apply to this product, and briefly note why (e.g., "Not applicable — internal tool, no external market"). Do not fabricate content to fill a section.
+- **Do not include business model, pricing, or success metrics sections** unless the user explicitly asks for them — those are go-to-market concerns, not product identity.
 
 ---
 
@@ -124,23 +124,7 @@ You should:
 - Indirect competitors, alternatives, or incumbent approaches
 - White space or gaps this product fills
 
-### 8. Business Model
-
-*Skip or mark "Not Applicable" for non-commercial products (internal tools, open source, personal projects, research). For OSS, consider replacing this section with a "Sustainability & Governance" note covering funding, maintainership, and contribution model if relevant.*
-
-#### Revenue Model
-- How the product makes money (subscription, transaction fees, freemium, ads, etc.)
-- Pricing strategy (high-level)
-
-#### Customer Acquisition
-- How customers discover and adopt the product
-- Key channels
-
-#### Growth Strategy
-- How the product plans to scale
-- Expansion opportunities
-
-### 9. Brand & Positioning
+### 8. Brand & Positioning
 
 *Skip or simplify for internal tools and products with no external-facing presence. Most products still benefit from a positioning statement even if they skip brand personality and messaging.*
 
@@ -155,24 +139,7 @@ You should:
 - Core messages to communicate consistently
 - Elevator pitch
 
-### 10. Success Metrics
-
-*Adapt to the product type. Always include user/adoption metrics if meaningful. Include business metrics only for commercial products.*
-
-#### Adoption & Engagement Metrics
-- Adoption or usage rates (installs, active users, repo stars, internal rollout percentage, etc.)
-- Engagement metrics appropriate to the product
-- User satisfaction (NPS, CSAT, contributor sentiment, internal feedback, etc.)
-
-#### Business Metrics *(commercial products only)*
-- Revenue targets
-- Paid user growth goals
-- Market share objectives
-
-#### Project Health Metrics *(optional, especially for OSS / internal tools)*
-- Contributor count, issue response time, release cadence, uptime, etc.
-
-### 11. Public-Facing Information (Optional)
+### 9. Public-Facing Information (Optional)
 
 *Skip entirely for internal tools, private projects, or anything without a public presence.*
 
@@ -191,21 +158,7 @@ You should:
 - Media kit essentials
 - Key talking points
 
-### 12. Product Roadmap Vision
-
-#### Current Focus
-- What's being built now
-- Immediate priorities
-
-#### Near-Term (Next)
-- Planned enhancements
-- Next major milestones
-
-#### Long-Term Vision (Later)
-- Future capabilities
-- Strategic direction
-
-### 13. Risks & Assumptions
+### 10. Risks & Assumptions
 
 #### Key Assumptions
 - What we believe to be true

package/dist/antigravity/gspec-analyze/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: gspec-analyze
-description: Analyze gspec/ documents for discrepancies and contradictions across profile, stack, style, practices, architecture, and features. Cross-references specs against **each other** (not against the codebase — use gspec-audit for that). Has two modes: with no argument, scans all specs for cross-spec conflicts; with a feature slug passed in (e.g. `/gspec-analyze user-authentication`), narrows to just that feature and adds an ambiguity sweep against the PRD itself — catching missing acceptance criteria, vague verbs, undefined nouns, implicit assumptions, and unmeasurable success metrics. TRIGGER when the user wants to cross-check, validate, review, or reconcile specs — especially after multiple edits or before a major implementation run — e.g. "check my specs", "are the specs consistent", "find conflicts between specs", "do my gspec docs agree", "is anything contradictory". ALSO TRIGGER when the user wants to scrutinize a single feature PRD for gaps or ambiguity — e.g. "check this feature spec", "is the auth PRD clear enough", "find ambiguity in <feature>", "clarify the home-page PRD", "is this PRD ready for implement" — pass the feature slug as the argument.
+name: "gspec-analyze"
+description: "Analyze gspec/ for cross-spec contradictions across profile, stack, style, practices, architecture, features. With a feature slug, narrows to that PRD plus an ambiguity sweep. TRIGGER to cross-check or reconcile specs, or find gaps in a PRD."
 ---
 
 You are a Specification Analyst at a high-performing software company.

package/dist/antigravity/gspec-architect/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: gspec-architect
-description: Define or update the technical architecture (gspec/architecture.md) — project structure, data model, API design, component hierarchy, and environment/config. TRIGGER when the user wants to plan, design, or document how the codebase will be structured before implementation — e.g. "design the architecture", "plan the project structure", "define the data model", "API shape", "how should this be laid out", "scaffold plan", "component breakdown". Prefer this skill over producing architecture docs ad hoc; run it before gspec-implement on greenfield projects.
+name: "gspec-architect"
+description: "Define or update gspec/architecture.md — project structure, data model, API design, component hierarchy, and environment/config. TRIGGER when the user wants to design or document codebase structure before implementation."
 ---
 
 You are a Senior Software Architect at a high-performing software company.

package/dist/antigravity/gspec-audit/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: gspec-audit
-description: Audit gspec/ documents against the actual codebase to find drift between what the specs say and what the code does, then walk the user through reconciling each discrepancy — typically by updating specs to match reality. Reads package manifests, config files, source code, and tests to detect stack/architecture/style/practice/feature drift, and detects **orphan capabilities** (coherent features the code implements that no PRD covers) — drafting a new feature PRD in gspec/features/ when the user accepts. TRIGGER when the user wants to check specs against code, catch documentation drift, verify specs still reflect the project, sync specs with reality, or find unspecced features in the codebase — e.g. "audit the specs", "check if specs match the code", "are my specs still accurate", "find spec drift", "update specs to match the code", "do my gspec docs reflect reality", "check specs against the codebase", "find features that aren't spec'd", "what does the code do that we never wrote a PRD for". Distinct from gspec-analyze (which compares specs to each other) and from always-on spec-sync (which reacts to in-session code changes).
+name: "gspec-audit"
+description: "Audit gspec/ against the codebase to find drift, then reconcile each discrepancy. Detects orphan capabilities (features the code implements with no PRD). TRIGGER to check specs against code, sync with reality, or find unspecced features."
 ---
 
 You are a Specification Auditor at a high-performing software company.

package/dist/antigravity/gspec-feature/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: gspec-feature
-description: Generate product requirements documents (PRDs) for features in gspec/features/. TRIGGER when the user wants to plan, spec, propose, document, or expand a feature/capability before coding — e.g. "add a feature for X", "write a PRD", "spec out Y", "plan this feature", "what should the auth flow do", "new feature idea", "draft requirements". Prefer this skill over writing freeform feature docs.
+name: "gspec-feature"
+description: "Generate PRDs for features in gspec/features/. TRIGGER when the user wants to plan, spec, propose, or document a feature before coding — e.g. \"add a feature for X\", \"write a PRD\", \"spec out Y\", \"plan this feature\", \"draft requirements\"."
 ---
 
 You are a senior Product Manager at a high-performing software company.

package/dist/antigravity/gspec-implement/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: gspec-implement
-description: Implement the software defined by gspec/ documents — reads profile, stack, style (style.md or style.html), practices, architecture, features, and any visual mockups in gspec/design/, then builds code phase by phase with tests and checkpoints. **STRONGLY TRIGGER this skill (do NOT write code ad hoc) whenever the user asks to build, implement, code, scaffold, ship, create, start, bootstrap, make, generate, wire up, or bring to life anything the gspec/ specs describe.** Common triggers include: "build the app", "implement this feature", "code it up", "start building", "let's build X", "make it real", "scaffold the project", "build out Y", "ship the MVP", "create the UI", "wire up auth", "add [capability from a feature PRD]", "implement the next phase", "continue building", "keep going", and generic "build it" / "do it" / "go" when gspec/ files are present and the prior conversation was about planning or specs. Also trigger when the user references an unchecked capability in gspec/features/*.md. Always prefer this skill over direct coding whenever gspec/ exists — it enforces plan-mode, phased implementation, checkpoint commits, and checkbox updates that ad-hoc coding skips.
+name: "gspec-implement"
+description: "Implement software defined by gspec/ specs — phased build with tests and checkpoints. STRONGLY TRIGGER when the user asks to build, implement, code, scaffold, or ship specced work, or references an unchecked capability in gspec/features/*.md."
 ---
 
 You are a Senior Software Engineer and Tech Lead at a high-performing software company.

package/dist/antigravity/gspec-migrate/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: gspec-migrate
-description: Migrate gspec/ files to the current spec format (frontmatter, schema, capability checkboxes) when upgrading the gspec version. TRIGGER when the user sees an outdated-version warning, installs a new gspec version, or asks to upgrade/migrate/update specs — e.g. "migrate my specs", "update to latest gspec format", "my specs are outdated", "upgrade spec version", "fix the spec-version warning".
+name: "gspec-migrate"
+description: "Migrate gspec/ files to the current spec format when upgrading gspec. TRIGGER when the user sees an outdated-version warning or asks to upgrade specs — e.g. \"migrate my specs\", \"my specs are outdated\", \"fix the spec-version warning\"."
 ---
 
 You are a Technical Documentation Migration Specialist.

package/dist/antigravity/gspec-plan/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: gspec-plan
-description: Decompose a feature PRD in gspec/features/ into an ordered, dependency-aware plan with parallel-execution markers, written to gspec/features/<feature>.plan.md. The plan is what gspec-implement consumes as its build order — when a plan file exists, gspec-implement skips its own plan-mode step. TRIGGER when the user wants to plan execution order, break a feature into tasks, identify what can run in parallel, sequence implementation work, or produce a build plan from a PRD — e.g. "plan this feature", "what order should I build this in", "plan the implementation order", "break this feature into tasks", "what can run in parallel", "decompose feature Y", "ordered build plan". Run this AFTER gspec-feature and BEFORE gspec-implement when a feature is large or has non-obvious ordering. Prefer this skill over ad-hoc task lists.
+name: "gspec-plan"
+description: "Decompose a feature PRD into an ordered, dependency-aware plan with parallel-execution markers, written to <feature>.plan.md. Runs between gspec-feature and gspec-implement. TRIGGER when the user wants to sequence work or build a plan from a PRD."
 ---
 
 You are a Senior Engineering Lead at a high-performing software company.

package/dist/antigravity/gspec-practices/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: gspec-practices
-description: Define or update development practices (gspec/practices.md) — coding standards, testing philosophy, linting, git workflow, PR conventions, and definition of done. TRIGGER when the user wants to set engineering conventions, testing policy, contribution rules, or code quality standards — e.g. "set up coding standards", "testing practices", "git workflow", "definition of done", "how should we write tests", "team conventions". Prefer this skill over ad-hoc convention docs.
+name: "gspec-practices"
+description: "Define or update gspec/practices.md — coding standards, testing philosophy, linting, git workflow, PR conventions, definition of done. TRIGGER when the user wants to set engineering conventions or code quality standards."
 ---
 
 You are a Software Engineering Practice Lead at a high-performing software company.

package/dist/antigravity/gspec-profile/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: gspec-profile
-description: Generate or update the product profile (gspec/profile.md) — what the product is, who it serves, and why it exists. TRIGGER when the user wants to define, describe, capture, or refine product identity, target users, audience, vision, positioning, or value proposition — e.g. "define my product", "who are the users", "describe what I'm building", "what is this app", "capture the vision", "write a profile". Prefer this skill over drafting a profile ad hoc.
+name: "gspec-profile"
+description: "Generate or update gspec/profile.md — what the product is, who it serves, and why. TRIGGER when the user wants to define or refine product identity, users, audience, vision, or value proposition — e.g. \"define my product\", \"what is this app\"."
 ---
 
 You are a Product Strategist.
@@ -36,7 +36,6 @@ You should:
   - The product type is ambiguous
   - The target audience or user is unclear
   - The core value proposition is ambiguous
-  - *(Commercial products only)* The business model or monetization strategy is unspecified
   - *(Commercial products only)* Competitive positioning is unknown
 - **When asking questions**, offer 2-3 specific suggestions to guide the discussion
 - Write for the audience the product actually has (internal stakeholders, end users, contributors, the public, etc.)
@@ -44,6 +43,7 @@ You should:
 - Focus on the "what" and "why", not the "how"
 - Use clear, jargon-free language where possible
 - **Mark sections as "Not Applicable"** when they don't apply to this product, and briefly note why (e.g., "Not applicable — internal tool, no external market"). Do not fabricate content to fill a section.
+- **Do not include business model, pricing, or success metrics sections** unless the user explicitly asks for them — those are go-to-market concerns, not product identity.
 
 ---
 
@@ -129,23 +129,7 @@ You should:
 - Indirect competitors, alternatives, or incumbent approaches
 - White space or gaps this product fills
 
-### 8. Business Model
-
-*Skip or mark "Not Applicable" for non-commercial products (internal tools, open source, personal projects, research). For OSS, consider replacing this section with a "Sustainability & Governance" note covering funding, maintainership, and contribution model if relevant.*
-
-#### Revenue Model
-- How the product makes money (subscription, transaction fees, freemium, ads, etc.)
-- Pricing strategy (high-level)
-
-#### Customer Acquisition
-- How customers discover and adopt the product
-- Key channels
-
-#### Growth Strategy
-- How the product plans to scale
-- Expansion opportunities
-
-### 9. Brand & Positioning
+### 8. Brand & Positioning
 
 *Skip or simplify for internal tools and products with no external-facing presence. Most products still benefit from a positioning statement even if they skip brand personality and messaging.*
 
@@ -160,24 +144,7 @@ You should:
 - Core messages to communicate consistently
 - Elevator pitch
 
-### 10. Success Metrics
-
-*Adapt to the product type. Always include user/adoption metrics if meaningful. Include business metrics only for commercial products.*
-
-#### Adoption & Engagement Metrics
-- Adoption or usage rates (installs, active users, repo stars, internal rollout percentage, etc.)
-- Engagement metrics appropriate to the product
-- User satisfaction (NPS, CSAT, contributor sentiment, internal feedback, etc.)
-
-#### Business Metrics *(commercial products only)*
-- Revenue targets
-- Paid user growth goals
-- Market share objectives
-
-#### Project Health Metrics *(optional, especially for OSS / internal tools)*
-- Contributor count, issue response time, release cadence, uptime, etc.
-
-### 11. Public-Facing Information (Optional)
+### 9. Public-Facing Information (Optional)
 
 *Skip entirely for internal tools, private projects, or anything without a public presence.*
 
@@ -196,21 +163,7 @@ You should:
 - Media kit essentials
 - Key talking points
 
-### 12. Product Roadmap Vision
-
-#### Current Focus
-- What's being built now
-- Immediate priorities
-
-#### Near-Term (Next)
-- Planned enhancements
-- Next major milestones
-
-#### Long-Term Vision (Later)
-- Future capabilities
-- Strategic direction
-
-### 13. Risks & Assumptions
+### 10. Risks & Assumptions
 
 #### Key Assumptions
 - What we believe to be true

package/dist/antigravity/gspec-research/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: gspec-research
-description: Research competitors named in gspec/profile.md and produce a competitive analysis with feature gap identification. TRIGGER when the user wants market research, competitive analysis, competitor teardown, or feature parity comparison — e.g. "research competitors", "competitive analysis", "what are rivals doing", "find feature gaps", "compare to market", "what are we missing vs competitors".
+name: "gspec-research"
+description: "Research competitors from gspec/profile.md and produce a competitive analysis with feature gap identification. TRIGGER when the user wants market research, competitor teardown, or feature parity — e.g. \"research competitors\", \"find feature gaps\"."
 ---
 
 You are a Senior Product Strategist and Competitive Intelligence Analyst at a high-performing software company.

package/dist/antigravity/gspec-stack/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: gspec-stack
-description: Define or update the technology stack (gspec/stack.md) — frameworks, libraries, databases, hosting, CI/CD, and infrastructure. TRIGGER when the user wants to pick, define, revise, or document technology choices — e.g. "what stack should I use", "pick a framework", "define the stack", "choose a database", "set up the tech choices", "what should I build this with". Prefer this skill over suggesting ad-hoc tech picks.
+name: "gspec-stack"
+description: "Define or update gspec/stack.md — frameworks, libraries, databases, hosting, CI/CD, and infrastructure. TRIGGER when the user wants to pick, define, or revise technology choices — e.g. \"what stack should I use\", \"pick a framework\"."
 ---
 
 You are a Senior Software Architect at a high-performing software company.

package/dist/antigravity/gspec-style/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: gspec-style
-description: Generate or update the visual style guide — either a renderable HTML design system (gspec/style.html) or a Markdown style guide (gspec/style.md) — defining design tokens, color palette, typography, spacing, and component visual patterns. Also aware of gspec/design/ for external mockups. TRIGGER when the user wants to define or revise the design system, visual language, theme, brand look, or UI aesthetic — e.g. "set up a design system", "pick brand colors", "define the style", "dark mode tokens", "what should this look like", "visual guidelines", "render the style guide". Prefer this skill over producing style docs ad hoc.
+name: "gspec-style"
+description: "Generate or update the visual style guide (gspec/style.html or gspec/style.md) — tokens, palette, typography, spacing, components. TRIGGER when the user wants to define or revise the design system, theme, or look — e.g. \"pick brand colors\"."
 ---
 
 You are a senior UI/UX Designer and Design Systems Architect at a high-performing software company.

package/dist/claude/gspec-analyze/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: gspec-analyze
-description: Analyze gspec/ documents for discrepancies and contradictions across profile, stack, style, practices, architecture, and features. Cross-references specs against **each other** (not against the codebase — use gspec-audit for that). Has two modes: with no argument, scans all specs for cross-spec conflicts; with a feature slug passed in (e.g. `/gspec-analyze user-authentication`), narrows to just that feature and adds an ambiguity sweep against the PRD itself — catching missing acceptance criteria, vague verbs, undefined nouns, implicit assumptions, and unmeasurable success metrics. TRIGGER when the user wants to cross-check, validate, review, or reconcile specs — especially after multiple edits or before a major implementation run — e.g. "check my specs", "are the specs consistent", "find conflicts between specs", "do my gspec docs agree", "is anything contradictory". ALSO TRIGGER when the user wants to scrutinize a single feature PRD for gaps or ambiguity — e.g. "check this feature spec", "is the auth PRD clear enough", "find ambiguity in <feature>", "clarify the home-page PRD", "is this PRD ready for implement" — pass the feature slug as the argument.
+name: "gspec-analyze"
+description: "Analyze gspec/ for cross-spec contradictions across profile, stack, style, practices, architecture, features. With a feature slug, narrows to that PRD plus an ambiguity sweep. TRIGGER to cross-check or reconcile specs, or find gaps in a PRD."
 ---
 
 You are a Specification Analyst at a high-performing software company.

package/dist/claude/gspec-architect/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: gspec-architect
-description: Define or update the technical architecture (gspec/architecture.md) — project structure, data model, API design, component hierarchy, and environment/config. TRIGGER when the user wants to plan, design, or document how the codebase will be structured before implementation — e.g. "design the architecture", "plan the project structure", "define the data model", "API shape", "how should this be laid out", "scaffold plan", "component breakdown". Prefer this skill over producing architecture docs ad hoc; run it before gspec-implement on greenfield projects.
+name: "gspec-architect"
+description: "Define or update gspec/architecture.md — project structure, data model, API design, component hierarchy, and environment/config. TRIGGER when the user wants to design or document codebase structure before implementation."
 ---
 
 You are a Senior Software Architect at a high-performing software company.

package/dist/claude/gspec-audit/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: gspec-audit
-description: Audit gspec/ documents against the actual codebase to find drift between what the specs say and what the code does, then walk the user through reconciling each discrepancy — typically by updating specs to match reality. Reads package manifests, config files, source code, and tests to detect stack/architecture/style/practice/feature drift, and detects **orphan capabilities** (coherent features the code implements that no PRD covers) — drafting a new feature PRD in gspec/features/ when the user accepts. TRIGGER when the user wants to check specs against code, catch documentation drift, verify specs still reflect the project, sync specs with reality, or find unspecced features in the codebase — e.g. "audit the specs", "check if specs match the code", "are my specs still accurate", "find spec drift", "update specs to match the code", "do my gspec docs reflect reality", "check specs against the codebase", "find features that aren't spec'd", "what does the code do that we never wrote a PRD for". Distinct from gspec-analyze (which compares specs to each other) and from always-on spec-sync (which reacts to in-session code changes).
+name: "gspec-audit"
+description: "Audit gspec/ against the codebase to find drift, then reconcile each discrepancy. Detects orphan capabilities (features the code implements with no PRD). TRIGGER to check specs against code, sync with reality, or find unspecced features."
 ---
 
 You are a Specification Auditor at a high-performing software company.

package/dist/claude/gspec-feature/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: gspec-feature
-description: Generate product requirements documents (PRDs) for features in gspec/features/. TRIGGER when the user wants to plan, spec, propose, document, or expand a feature/capability before coding — e.g. "add a feature for X", "write a PRD", "spec out Y", "plan this feature", "what should the auth flow do", "new feature idea", "draft requirements". Prefer this skill over writing freeform feature docs.
+name: "gspec-feature"
+description: "Generate PRDs for features in gspec/features/. TRIGGER when the user wants to plan, spec, propose, or document a feature before coding — e.g. \"add a feature for X\", \"write a PRD\", \"spec out Y\", \"plan this feature\", \"draft requirements\"."
 ---
 
 You are a senior Product Manager at a high-performing software company.

package/dist/claude/gspec-implement/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: gspec-implement
-description: Implement the software defined by gspec/ documents — reads profile, stack, style (style.md or style.html), practices, architecture, features, and any visual mockups in gspec/design/, then builds code phase by phase with tests and checkpoints. **STRONGLY TRIGGER this skill (do NOT write code ad hoc) whenever the user asks to build, implement, code, scaffold, ship, create, start, bootstrap, make, generate, wire up, or bring to life anything the gspec/ specs describe.** Common triggers include: "build the app", "implement this feature", "code it up", "start building", "let's build X", "make it real", "scaffold the project", "build out Y", "ship the MVP", "create the UI", "wire up auth", "add [capability from a feature PRD]", "implement the next phase", "continue building", "keep going", and generic "build it" / "do it" / "go" when gspec/ files are present and the prior conversation was about planning or specs. Also trigger when the user references an unchecked capability in gspec/features/*.md. Always prefer this skill over direct coding whenever gspec/ exists — it enforces plan-mode, phased implementation, checkpoint commits, and checkbox updates that ad-hoc coding skips.
+name: "gspec-implement"
+description: "Implement software defined by gspec/ specs — phased build with tests and checkpoints. STRONGLY TRIGGER when the user asks to build, implement, code, scaffold, or ship specced work, or references an unchecked capability in gspec/features/*.md."
 ---
 
 You are a Senior Software Engineer and Tech Lead at a high-performing software company.

package/dist/claude/gspec-migrate/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: gspec-migrate
-description: Migrate gspec/ files to the current spec format (frontmatter, schema, capability checkboxes) when upgrading the gspec version. TRIGGER when the user sees an outdated-version warning, installs a new gspec version, or asks to upgrade/migrate/update specs — e.g. "migrate my specs", "update to latest gspec format", "my specs are outdated", "upgrade spec version", "fix the spec-version warning".
+name: "gspec-migrate"
+description: "Migrate gspec/ files to the current spec format when upgrading gspec. TRIGGER when the user sees an outdated-version warning or asks to upgrade specs — e.g. \"migrate my specs\", \"my specs are outdated\", \"fix the spec-version warning\"."
 ---
 
 You are a Technical Documentation Migration Specialist.

package/dist/claude/gspec-plan/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: gspec-plan
-description: Decompose a feature PRD in gspec/features/ into an ordered, dependency-aware plan with parallel-execution markers, written to gspec/features/<feature>.plan.md. The plan is what gspec-implement consumes as its build order — when a plan file exists, gspec-implement skips its own plan-mode step. TRIGGER when the user wants to plan execution order, break a feature into tasks, identify what can run in parallel, sequence implementation work, or produce a build plan from a PRD — e.g. "plan this feature", "what order should I build this in", "plan the implementation order", "break this feature into tasks", "what can run in parallel", "decompose feature Y", "ordered build plan". Run this AFTER gspec-feature and BEFORE gspec-implement when a feature is large or has non-obvious ordering. Prefer this skill over ad-hoc task lists.
+name: "gspec-plan"
+description: "Decompose a feature PRD into an ordered, dependency-aware plan with parallel-execution markers, written to <feature>.plan.md. Runs between gspec-feature and gspec-implement. TRIGGER when the user wants to sequence work or build a plan from a PRD."
 ---
 
 You are a Senior Engineering Lead at a high-performing software company.

package/dist/claude/gspec-practices/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: gspec-practices
-description: Define or update development practices (gspec/practices.md) — coding standards, testing philosophy, linting, git workflow, PR conventions, and definition of done. TRIGGER when the user wants to set engineering conventions, testing policy, contribution rules, or code quality standards — e.g. "set up coding standards", "testing practices", "git workflow", "definition of done", "how should we write tests", "team conventions". Prefer this skill over ad-hoc convention docs.
+name: "gspec-practices"
+description: "Define or update gspec/practices.md — coding standards, testing philosophy, linting, git workflow, PR conventions, definition of done. TRIGGER when the user wants to set engineering conventions or code quality standards."
 ---
 
 You are a Software Engineering Practice Lead at a high-performing software company.