Arc Writing Skills FAQs

Question 1

How does TDD apply to documentation?

Accepted Answer

In this context, a test case is a pressure scenario for a subagent. 'Red' is the agent failing the task without the skill, 'Green' is the agent passing with the skill, and 'Refactor' is closing loopholes to prevent rationalization.

Question 2

Where are these skills stored on my system?

Accepted Answer

Depending on your platform, skills are typically stored in hidden directories such as ~/.claude/skills/ for Claude Code or ~/.cursor/skills/ for Cursor.

Question 3

Why shouldn't a skill description summarize the workflow?

Accepted Answer

Summarizing the workflow in the YAML description can cause Claude to skip reading the full skill content. Descriptions should focus strictly on 'When to use' symptoms and triggering conditions.

Question 4

What is the difference between a skill and CLAUDE.md?

Accepted Answer

Skills are reusable techniques, patterns, or tools applicable across multiple projects. Project-specific conventions and mechanical constraints should remain in a project's CLAUDE.md file.

Question 5

What is the Iron Law of Arc Writing Skills?

Accepted Answer

The Iron Law states: 'No skill without a failing test first.' You must observe an AI agent fail a pressure scenario before writing the skill to ensure the documentation actually solves a real behavioral gap.

Arc Writing Skills

主要功能

使用场景

Arc Writing Skills

主要功能

使用场景