How do I install the Aico Pm Clarification skill?

Run npx skillmds@latest add majiayu000/aico-pm-clarification-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Aico Pm Clarification safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Aico Pm Clarification?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Aico Pm Clarification free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Aico Pm Clarification?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Aico Pm Clarification by majiayu000

Name: Aico Pm Clarification
Rating: 4.5 (4 reviews)
Author: majiayu000

Aico Pm Clarification

Resolve requirement ambiguities through STRUCTURED questioning: one question at a time, with recommended options and reasoning. UNIQUE VALUE: Prevents overwhelming users with multiple questions. Provides expert recommendations for each decision. Use this skill when: - Running /pm.clarify command - User says "unclear", "not sure what this means", "confused about" - User asks "what does X mean?", "how should X work?", "can you clarify?" - Requirements have conflicting or inconsistent details - Stories are missing acceptance criteria or have gaps - Need to fill information gaps BEFORE development can proceed Process: Ask ONE question at a time (max 5 per session), provide recommended option with reasoning. DO NOT ask multiple questions at once - this overwhelms users.

majiayu000 Updated Sep 22, 2026 567 repo stars

File contents

Requirement Clarification

Language Configuration

Before generating any content, check aico.json in project root for language field to determine the output language. If not set, default to English.

Process

Scan context: Check docs/reference/pm/ for existing documentation
Identify ambiguities: Categorize by type (scope, behavior, data, edge cases)
Prioritize: Sort by impact: scope > security > UX > technical
Ask ONE question at a time: Max 5 questions per session
Provide recommendation: Each question should have a recommended option with reasoning
Update docs: Document each answer immediately

Question Format

### Question [N]: [Topic]

**Context**: [Quote relevant requirement]

**Ambiguity**: [What's unclear]

**Options**:
| Option | Description | Implications |
|--------|-------------|--------------|
| A | [First option] | [Trade-offs] |
| B | [Second option] | [Trade-offs] |

**Recommended**: [Option] because [reasoning]

Ambiguity Categories

Category	Focus
Scope	What's included/excluded
Behavior	How feature should work
Data	What information is needed
Edge cases	Unusual scenarios
Error handling	Failure modes

Key Rules

ALWAYS ask ONE question per message, never batch
MUST provide recommended option with reasoning for each question
ALWAYS prioritize blocking issues (scope, security) over minor details
Max 5 questions per clarification session

Common Mistakes

❌ Ask all questions at once → ✅ One at a time
❌ Open-ended questions → ✅ Multiple choice with recommendation
❌ Low-impact questions → ✅ Focus on blocking issues first

---name: aico-pm-clarification-2description: Resolve requirement ambiguities through STRUCTURED questioning: one question at a time, with recommended options and reasoning. UNIQUE VALUE: Prevents overwhelming users with multiple questions. Provides expert recommendations for each decision. Use this skill when: - Running /pm.clarify command - User says "unclear", "not sure what this means", "confused about" - User asks "what does X mean?", "how should X work?", "can you clarify?" - Requirements have conflicting or inconsistent details - Stories are missing acceptance criteria or have gaps - Need to fill information gaps BEFORE development can proceed Process: Ask ONE question at a time (max 5 per session), provide recommended option with reasoning. DO NOT ask multiple questions at once - this overwhelms users.---# Requirement Clarification## Language ConfigurationBefore generating any content, check `aico.json` in project root for `language` field to determine the output language. If not set, default to English.## Process1. **Scan context**: Check `docs/reference/pm/` for existing documentation2. **Identify ambiguities**: Categorize by type (scope, behavior, data, edge cases)3. **Prioritize**: Sort by impact: scope > security > UX > technical4. **Ask ONE question at a time**: Max 5 questions per session5. **Provide recommendation**: Each question should have a recommended option with reasoning6. **Update docs**: Document each answer immediately## Question Format```markdown### Question [N]: [Topic]**Context**: [Quote relevant requirement]**Ambiguity**: [What's unclear]**Options**:| Option | Description | Implications ||--------|-------------|--------------|| A | [First option] | [Trade-offs] || B | [Second option] | [Trade-offs] |**Recommended**: [Option] because [reasoning]```## Ambiguity Categories| Category | Focus || -------------- | -------------------------- || Scope | What's included/excluded || Behavior | How feature should work || Data | What information is needed || Edge cases | Unusual scenarios || Error handling | Failure modes |## Key Rules- ALWAYS ask ONE question per message, never batch- MUST provide recommended option with reasoning for each question- ALWAYS prioritize blocking issues (scope, security) over minor details- Max 5 questions per clarification session## Common Mistakes- ❌ Ask all questions at once → ✅ One at a time- ❌ Open-ended questions → ✅ Multiple choice with recommendation- ❌ Low-impact questions → ✅ Focus on blocking issues first

Frequently asked questions