← All stories
discussionr/AI_Agents · Nov 10, 2026

Skills vs linked documentation: should AI workflows reuse human docs or get their own skills?

A developer rolling out AI workflows in a company project asks whether to write AI-specific skills or reuse existing human documentation, using branch-naming policies as the test case. The thread gets at a practical split: skills should carry the short, machine-readable rule with examples, while the human document keeps the reasoning behind it. It is a good reminder that converting a rule beats pasting a document.

Read the full source →