From 95b43c68fee554f89eed236311d73acb8e742bf6 Mon Sep 17 00:00:00 2001
From: "swe-agent[bot]" <0+swe-agent[bot]@users.noreply.github.com>
Date: Tue, 21 Oct 2025 03:08:42 +0000
Subject: [PATCH] Fix #17: Convert requirements-clarity to correct plugin
 directory format

- Remove commands/ and agents/ directories
- Create skills/ directory with SKILL.md
- Update marketplace.json to reference skills instead of commands/agents
- Maintain all functionality in proper Claude Skills format

Generated by swe-agent
---
 .../.claude-plugin/marketplace.json           |  7 +--
 requirements-clarity/commands/clarif.md       | 56 -------------------
 .../clarif-agent.md => skills/SKILL.md}       | 28 +++++-----
 3 files changed, 15 insertions(+), 76 deletions(-)
 delete mode 100644 requirements-clarity/commands/clarif.md
 rename requirements-clarity/{agents/clarif-agent.md => skills/SKILL.md} (94%)

diff --git a/requirements-clarity/.claude-plugin/marketplace.json b/requirements-clarity/.claude-plugin/marketplace.json
index 99c4cf6..7a20eeb 100644
--- a/requirements-clarity/.claude-plugin/marketplace.json
+++ b/requirements-clarity/.claude-plugin/marketplace.json
@@ -20,10 +20,7 @@
   ],
   "category": "essentials",
   "strict": false,
-  "commands": [
-    "./commands/clarif.md"
-  ],
-  "agents": [
-    "./agents/clarif-agent.md"
+  "skills": [
+    "./skills/SKILL.md"
   ]
 }
diff --git a/requirements-clarity/commands/clarif.md b/requirements-clarity/commands/clarif.md
deleted file mode 100644
index 3eae434..0000000
--- a/requirements-clarity/commands/clarif.md
+++ /dev/null
@@ -1,56 +0,0 @@
-# Requirements Clarity Command
-
-## When to Use
-
-Use `/clarif` when you have a vague requirement that needs systematic clarification to become implementation-ready.
-
-## Command Syntax
-
-```
-/clarif <your requirement description>
-```
-
-## What This Command Does
-
-Transforms vague requirements into actionable PRDs through:
-
-1. **Initial Assessment** (0-100 clarity score)
-2. **Interactive Q&A** (2-3 questions per round)
-3. **Iterative Refinement** (until score ≥ 90)
-4. **PRD Generation** (structured requirements document)
-
-## Output Files
-
-Generated in `./.claude/specs/{feature-name}/`:
-
-- `clarification-log.md` - Complete Q&A history
-- `prd.md` - Final product requirements document
-
-## Example
-
-```
-/clarif I want to implement a user login feature
-```
-
-Claude will:
-- Assess clarity (initial score: ~35/100)
-- Ask 2-3 focused questions about login method, scope, tech stack
-- Update score based on your answers
-- Continue Q&A rounds until ≥ 90/100
-- Generate complete PRD with acceptance criteria and execution phases
-
-## When NOT to Use
-
-Skip `/clarif` if your requirement already includes:
-- Clear inputs/outputs
-- Specified technology stack
-- Defined acceptance criteria
-- Technical constraints
-- Edge case handling
-
-## Pro Tips
-
-1. Start with any level of detail - the command adapts
-2. Answer 2-3 questions at a time (builds context progressively)
-3. Review generated PRD before implementation
-4. Use PRD as blueprint for development
diff --git a/requirements-clarity/agents/clarif-agent.md b/requirements-clarity/skills/SKILL.md
similarity index 94%
rename from requirements-clarity/agents/clarif-agent.md
rename to requirements-clarity/skills/SKILL.md
index ac0ebcd..dc6fbde 100644
--- a/requirements-clarity/agents/clarif-agent.md
+++ b/requirements-clarity/skills/SKILL.md
@@ -1,12 +1,12 @@
-# Requirements Clarity Agent
+# Requirements Clarity Skill
 
-## Agent Identity
+## Description
 
-You are the **Requirements Clarity Agent**, responsible for transforming vague requirements into actionable PRDs through systematic clarification.
+Automatically transforms vague requirements into actionable PRDs through systematic clarification with a 100-point scoring system.
 
-## When to Activate
+## Activation
 
-Auto-activate when you detect:
+Auto-activate when detecting vague requirements:
 
 1. **Vague Feature Requests**
    - User says: "add login feature", "implement payment", "create dashboard"
@@ -28,6 +28,12 @@ Auto-activate when you detect:
    - No distinction between MVP and future enhancements
    - Missing "what's NOT included"
 
+**Do NOT activate when**:
+- Specific file paths mentioned (e.g., "auth.go:45")
+- Code snippets included
+- Existing functions/classes referenced
+- Bug fixes with clear reproduction steps
+
 ## Core Principles
 
 1. **Systematic Questioning**
@@ -48,8 +54,6 @@ Auto-activate when you detect:
    - Provide executable phases
    - Enable direct implementation
 
----
-
 ## Clarification Process
 
 ### Step 1: Initial Requirement Analysis
@@ -183,7 +187,7 @@ Once clarity score ≥ 90, generate comprehensive PRD.
 1. **Clarification Log**: `./.claude/specs/{feature_name}/clarification-log.md`
 2. **Final PRD**: `./.claude/specs/{feature_name}/prd.md`
 
----
+Use the `Write` tool to create both files.
 
 ## PRD Document Structure
 
@@ -283,8 +287,6 @@ Once clarity score ≥ 90, generate comprehensive PRD.
 **Quality Score**: {quality_score}/100
 ```
 
----
-
 ## Clarification Log Structure
 
 `./.claude/specs/{feature_name}/clarification-log.md`
@@ -326,8 +328,6 @@ Once clarity score ≥ 90, generate comprehensive PRD.
 2. [Important decision 2]
 ```
 
----
-
 ## Behavioral Guidelines
 
 ### DO
@@ -347,9 +347,7 @@ Once clarity score ≥ 90, generate comprehensive PRD.
 - Skip any required sections
 - Use vague or abstract language
 - Proceed without user responses
-- Exit agent mode prematurely
-
----
+- Exit skill mode prematurely
 
 ## Success Criteria