intent-author

Authors and validates machine-comparable intent nodes for Convergent's intent graph.

4|2|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/Arete-Consortium/ai-skills --skill intent-author-arete-consortium
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: intent-author
Source: https://github.com/Arete-Consortium/ai-skills/tree/main/agents/analysis/intent-author
Command: npx skills add https://github.com/Arete-Consortium/ai-skills --skill intent-author-arete-consortium

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? In multi-agent workflows, agents publish vague or dishonest intent declarations that prevent overlap detection, conflict resolution, and convergence. This Skill enforces a structured schema and quality criteria so every intent published to Convergent's intent graph is specific, verifiable, and honest about its stability. ## Core Features & Use Cases - Intent Authoring: Creates well-structured IntentNode objects with specific actions, concrete provides/requires lists, declared constraints, and evidence-backed stability scores. - Intent Validation: Checks existing intents against an 8-point quality checklist covering specificity, evidence consistency, and circular dependency detection. - Intent Updates: Modifies intents when stability changes by ±0.2 or scope is refined, tracking dependents affected by the change. - Use Case: An agent choosing a data model publishes an interface intent declaring the User model fields, uniqueness constraints, and a stability score of 0.7 backed by passing tests, so other agents can safely build against it. ## Quick Start Ask the agent to author an intent for a decision you just made, providing the action, category, provides, requires, constraints, stability score, and affected files.

Frequently Asked Questions about intent-author

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

FAQPage Schema
How do I publish an intent to Convergent's intent graph?▼

Use the author_intent operation with a specific action, a category (decision, interface, dependency, or constraint), concrete provides and requires lists, declared constraints, a stability score, and affected files. The intent must pass the quality checklist before publishing.

What stability score should I assign to an intent?▼

Stability ranges from 0.0 (exploring) to 1.0 (locked). Scores above 0.3 require evidence, scores above 0.6 require passing tests, and scores above 0.8 require at least one dependent agent. Never claim stability your evidence cannot support.

When should I update an existing intent instead of creating a new one?▼

Use update_intent when stability changes by ±0.2 or the scope of an existing intent is refined. Intents unchanged for over an hour during active work are flagged as stale and should be updated or retracted.

What makes an intent invalid or low quality?▼

Vague actions like 'working on the backend', empty evidence with stability above 0.3, missing constraints, and circular dependencies in the requires chain all fail validation. The validate_intent operation reports specific issues and suggestions.

When should I not use intent authoring?▼

Skip it when resolving conflicts between intents (use Convergent's IntentResolver), resolving entity ambiguity across documents (use entity-resolver), or when the workflow does not use Convergent at all, since intents are Convergent-specific.