intent-aligner

Extract and formalize user intent into structured Markdown and HTML specifications.

Updated May 9, 2026
One-click install
npx skills add https://github.com/yes506/ai-driven-items --skill intent-aligner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: intent-aligner
Source: https://github.com/yes506/ai-driven-items/tree/main/skills/intent-aligner
Command: npx skills add https://github.com/yes506/ai-driven-items --skill intent-aligner

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This skill prevents wasted development effort by ensuring the user's true intent is fully understood, scoped, and verified before any planning or coding begins.

Core Features & Use Cases

  • Interactive Elicitation: Uses Socratic loops, 5 Whys, and example/counter-example disambiguation to surface hidden assumptions.
  • Dual-Format Artifacts: Generates both an AI-parseable Markdown seed and a human-verifiable HTML report.
  • Use Case: When you have a vague idea for a new feature, use this skill to transform your initial thoughts into a structured, validated project specification that downstream planning agents can execute with high confidence.

Quick Start

Run the intent-aligner skill to start a new project elicitation session for your feature idea.

Frequently Asked Questions about intent-aligner

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

FAQPage Schema
How do I formalize a vague feature idea into a structured project specification?

To formalize a vague feature idea, you can use interactive elicitation loops to surface hidden assumptions, classify goals, and produce a structured project specification. This ensures your intent is aligned before codebase modification.

What is the best way to extract user intent before starting AI planning workflows?

Extracting user intent before AI planning workflows involves running Socratic loops and 5 Whys analysis to disambiguate goals and constraints. This process prevents wasted development effort by verifying true intent before any coding begins.

How does interactive elicitation classify project constraints and success criteria?

Interactive elicitation classifies constraints and success criteria by using example and counter-example disambiguation during dialog sessions. This directly transforms initial thoughts into validated specifications for downstream planning agents.

Can I generate machine-readable Markdown seeds and HTML reports from project goals?

Yes, you can generate both machine-readable Markdown seeds and human-verifiable HTML reports from project goals. These dual-format artifacts ensure AI-parseable specifications and human alignment before execution.

Do I need python3 installed to run intent alignment and specification sessions?

Yes, you need python3 installed as a dependency to run elicitation sessions and generate specifications. The skill relies on this environment to produce the structured Markdown and HTML outputs.

When should I not use intent elicitation for my software engineering tasks?

You should not use intent elicitation if your software engineering task already has a fully scoped, validated specification. This approach is designed specifically for vague ideas needing disambiguation before planning agents can execute confidently.