What happens to files that the skill can't fix automatically?

Files with content issues (like missing anchors or excessive length) are tagged with a 'needs' field in the frontmatter, allowing agents or developers to pick them up later.

Can I preview changes before they are applied?

Yes, you can use the --dry-run flag to generate a normalization report without modifying any files in your project.

Does this skill work with modular project structures?

Yes, it recursively scans for intent directories at both the root level and within specific sub-modules.

What is the IDD standard mentioned in this skill?

Intent-Driven Development (IDD) is a core practice of the AINE methodology that focuses on defining clear intent through structured documentation before implementation.

Will Intent Normalize overwrite my existing documentation?

No, the skill is designed to be idempotent and additive. It fixes mechanical formatting and structure issues but flags content-related problems for manual review.

Intent Normalize

Name: Intent Normalize
Author: ArcBlock

byArcBlock

•

Productivity & Workflow

Standardizes and repairs project intent and planning files to ensure compliance with Intent-Driven Development (IDD) practices.

Intent Normalize is a specialized utility designed for projects following the Intent-Driven Development (IDD) methodology. It automatically scans project directories, injects missing frontmatter, and organizes planning files into a standardized structure. By resolving mechanical issues like naming conventions and directory layouts while flagging complex content gaps for human review or automated agents, it maintains a clean, machine-readable, and actionable project roadmap.

Key Features

01Idempotent execution ensuring consistent results across multiple runs

02Automatic frontmatter injection for Intent and Planning files

03Intelligent flagging of content issues using the 'needs' metadata field

047 GitHub stars

05Heuristic status inference based on project context and file content

06Automated creation of standard IDD directories like records, archive, and data

Use Cases

01Preparing project intent files for automated processing by TeamSwarm or other AI agents

02Cleaning up inconsistent planning documentation and directory structures before a sprint

03Migrating an existing software project to the Intent-Driven Development (IDD) standard

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add arcblock/idd intent-normalize

For use in Claude.ai and ChatGPT

Download Skill