How does the annotate skill handle conflicting changes?

It utilizes a strict concurrency locking mechanism (.lock file) to prevent simultaneous edits and performs a cross-impact assessment to identify how modifications in one file layer affect others.

Does this skill modify my source code directly?

Yes, it executes changes to files based on the UI annotations provided, but it ensures safety through path validation, content sanitization, and automated Git commits for easy rollback.

What happens if I change a high-level requirement file?

When a 'Requirement' layer file like .target.md is modified, the skill triggers a high-impact assessment that can cascade changes to plans and tests, often transitioning the task status to 're-planning'.

How are comments handled differently from edits?

Unlike edits, comments never trigger state transitions or modify existing code logic; they are appended as blockquotes to facilitate communication between the user and the AI.

What types of annotations are supported?

The skill supports four specific annotation types: Insert (add text), Delete (remove text), Replace (overwrite text), and Comment (add discussion blockquotes).

Task AI: Smart Annotations

Name: Task AI: Smart Annotations
Author: huacheng

byhuacheng

•

生産性とワークフロー

Processes structured file annotations to manage task lifecycles, requirement updates, and planning shifts through AI-driven triage.

The annotate skill is a sophisticated component of the task-ai suite designed to manage the lifecycle of development tasks by processing structured user feedback. It interprets Insert, Delete, Replace, and Comment actions, categorizing them into semantic layers—ranging from high-level requirements to low-level information—to automatically assess cross-impacts and update task states. This ensures that changes to a project's goals or plans are consistently propagated across all system files, maintaining a coherent development workflow with built-in concurrency protection and automated Git versioning.

主な機能

011 GitHub stars

02Precise cursor-based positioning for complex file modifications

03Automated cross-impact assessment to detect downstream effects

04Multi-layer triage for Requirement, Planning, and Evaluation files

05Smart state transitions and atomic .status.json updates

06Concurrency locking to prevent conflicts during automated tasks

ユースケース

01Reviewing AI-generated plans and providing inline feedback via structured comments

02Executing batch updates to system files based on UI-driven interactions

03Modifying project requirements and automatically triggering a re-planning phase

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add huacheng/moonview annotate

For use in Claude.ai and ChatGPT

Download Skill