diff --git a/.agents/skills b/.agents/skills new file mode 120000 index 0000000..6838a11 --- /dev/null +++ b/.agents/skills @@ -0,0 +1 @@ +../.ai/skills \ No newline at end of file diff --git a/.ai/skills/plain-english b/.ai/skills/plain-english new file mode 120000 index 0000000..34d7feb --- /dev/null +++ b/.ai/skills/plain-english @@ -0,0 +1 @@ +../../vendor/claude-plain-english-skill/skills/plain-english \ No newline at end of file diff --git a/.ai/skills/simple-english b/.ai/skills/simple-english new file mode 120000 index 0000000..168706a --- /dev/null +++ b/.ai/skills/simple-english @@ -0,0 +1 @@ +../../vendor/claude-plain-english-skill/skills/simple-english \ No newline at end of file diff --git a/.gitmodules b/.gitmodules index b3d4418..b021115 100644 --- a/.gitmodules +++ b/.gitmodules @@ -28,3 +28,6 @@ [submodule "vendor/stokowski"] path = vendor/stokowski url = git@github.com:bougyman/stokowski +[submodule "vendor/claude-plain-english-skill"] + path = vendor/claude-plain-english-skill + url = git@github.com:b1rdmania/claude-plain-english-skill diff --git a/AGENTS.md b/AGENTS.md index e8307ef..fc9073a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -3,6 +3,16 @@ This document provides an index and source reference of guidelines, processes, and best practices for agents to follow. +## Documents + +Use the [`simple-english`](vendor/claude-plain-english-skill/skills/simple-english) skill when +authoring technical documentation or instructions. + +Use the [`plain-english`](vendor/claude-plain-english-skill/skills/plain-english) skill when +authoring non-technical documentation, marketing copy, or other content intended for a general audience. + +Do not apply both to the same text. + ## The Plan - Initial Plan: documents/initial-plan.adoc (historical snapshot - not diff --git a/vendor/claude-plain-english-skill b/vendor/claude-plain-english-skill new file mode 160000 index 0000000..1e1501e --- /dev/null +++ b/vendor/claude-plain-english-skill @@ -0,0 +1 @@ +Subproject commit 1e1501e0e4da21d63b6611e2f258cf28c356a86c