Unsupervisedcom · nhorton · Jan 21, 2026 · Jan 21, 2026 · Jan 21, 2026
diff --git a/.claude/skills/add_platform.add_capabilities/SKILL.md b/.claude/skills/add_platform.add_capabilities/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: add_platform.add_capabilities
-description: "Update job schema and adapters with any new hook events the platform supports"
+description: "Updates job schema and adapters with any new hook events the platform supports. Use after research to extend DeepWork's hook system."
 user-invocable: false
 hooks:
   Stop:
@@ -24,7 +24,7 @@ hooks:
 
 **Step 2/4** in **add_platform** workflow
 
-> Add a new AI platform to DeepWork with adapter, templates, and tests
+> Adds a new AI platform to DeepWork with adapter, templates, and tests. Use when integrating Cursor, Windsurf, or other AI coding tools.
 
 ## Prerequisites (Verify First)
 
@@ -33,7 +33,7 @@ Before proceeding, confirm these steps are complete:
 
 ## Instructions
 
-**Goal**: Update job schema and adapters with any new hook events the platform supports
+**Goal**: Updates job schema and adapters with any new hook events the platform supports. Use after research to extend DeepWork's hook system.
 
 # Add Hook Capabilities
 
@@ -211,6 +211,13 @@ Use branch format: `deepwork/add_platform-[instance]-YYYYMMDD`
 - `job_schema.py`
 - `adapters.py`
 
+## Guardrails
+
+- Do NOT skip prerequisite verification if this step has dependencies
+- Do NOT produce partial outputs; complete all required outputs before finishing
+- Do NOT proceed without required inputs; ask the user if any are missing
+- Do NOT modify files outside the scope of this step's defined outputs
+
 ## Quality Validation
 
 Stop hooks will automatically validate your work. The loop continues until all criteria pass.

diff --git a/.claude/skills/add_platform.implement/SKILL.md b/.claude/skills/add_platform.implement/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: add_platform.implement
-description: "Add platform adapter, templates, tests with 100% coverage, and README documentation"
+description: "Creates platform adapter, templates, tests with 100% coverage, and README documentation. Use after adding hook capabilities."
 user-invocable: false
 hooks:
   Stop:
@@ -28,7 +28,7 @@ hooks:
 
 **Step 3/4** in **add_platform** workflow
 
-> Add a new AI platform to DeepWork with adapter, templates, and tests
+> Adds a new AI platform to DeepWork with adapter, templates, and tests. Use when integrating Cursor, Windsurf, or other AI coding tools.
 
 ## Prerequisites (Verify First)
 
@@ -38,7 +38,7 @@ Before proceeding, confirm these steps are complete:
 
 ## Instructions
 
-**Goal**: Add platform adapter, templates, tests with 100% coverage, and README documentation
+**Goal**: Creates platform adapter, templates, tests with 100% coverage, and README documentation. Use after adding hook capabilities.
 
 # Implement Platform Support
 
@@ -310,6 +310,13 @@ Use branch format: `deepwork/add_platform-[instance]-YYYYMMDD`
 - `tests/` (directory)
 - `README.md`
 
+## Guardrails
+
+- Do NOT skip prerequisite verification if this step has dependencies
+- Do NOT produce partial outputs; complete all required outputs before finishing
+- Do NOT proceed without required inputs; ask the user if any are missing
+- Do NOT modify files outside the scope of this step's defined outputs
+
 ## Quality Validation
 
 Stop hooks will automatically validate your work. The loop continues until all criteria pass.

diff --git a/.claude/skills/add_platform.research/SKILL.md b/.claude/skills/add_platform.research/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: add_platform.research
-description: "Capture CLI configuration and hooks system documentation for the new platform"
+description: "Captures CLI configuration and hooks system documentation for the new platform. Use when starting platform integration."
 user-invocable: false
 hooks:
   Stop:
@@ -25,12 +25,12 @@ hooks:
 
 **Step 1/4** in **add_platform** workflow
 
-> Add a new AI platform to DeepWork with adapter, templates, and tests
+> Adds a new AI platform to DeepWork with adapter, templates, and tests. Use when integrating Cursor, Windsurf, or other AI coding tools.
 
 
 ## Instructions
 
-**Goal**: Capture CLI configuration and hooks system documentation for the new platform
+**Goal**: Captures CLI configuration and hooks system documentation for the new platform. Use when starting platform integration.
 
 # Research Platform Documentation
 
@@ -261,6 +261,13 @@ Use branch format: `deepwork/add_platform-[instance]-YYYYMMDD`
 - `cli_configuration.md`
 - `hooks_system.md`
 
+## Guardrails
+
+- Do NOT skip prerequisite verification if this step has dependencies
+- Do NOT produce partial outputs; complete all required outputs before finishing
+- Do NOT proceed without required inputs; ask the user if any are missing
+- Do NOT modify files outside the scope of this step's defined outputs
+
 ## Quality Validation
 
 Stop hooks will automatically validate your work. The loop continues until all criteria pass.

diff --git a/.claude/skills/add_platform.verify/SKILL.md b/.claude/skills/add_platform.verify/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: add_platform.verify
-description: "Set up platform directories and verify deepwork install works correctly"
+description: "Sets up platform directories and verifies deepwork install works correctly. Use after implementation to confirm integration."
 user-invocable: false
 hooks:
   Stop:
@@ -23,7 +23,7 @@ hooks:
 
 **Step 4/4** in **add_platform** workflow
 
-> Add a new AI platform to DeepWork with adapter, templates, and tests
+> Adds a new AI platform to DeepWork with adapter, templates, and tests. Use when integrating Cursor, Windsurf, or other AI coding tools.
 
 ## Prerequisites (Verify First)
 
@@ -32,7 +32,7 @@ Before proceeding, confirm these steps are complete:
 
 ## Instructions
 
-**Goal**: Set up platform directories and verify deepwork install works correctly
+**Goal**: Sets up platform directories and verifies deepwork install works correctly. Use after implementation to confirm integration.
 
 # Verify Installation
 
@@ -185,6 +185,13 @@ Use branch format: `deepwork/add_platform-[instance]-YYYYMMDD`
 **Required outputs**:
 - `verification_checklist.md`
 
+## Guardrails
+
+- Do NOT skip prerequisite verification if this step has dependencies
+- Do NOT produce partial outputs; complete all required outputs before finishing
+- Do NOT proceed without required inputs; ask the user if any are missing
+- Do NOT modify files outside the scope of this step's defined outputs
+
 ## Quality Validation
 
 Stop hooks will automatically validate your work. The loop continues until all criteria pass.

diff --git a/.claude/skills/add_platform/SKILL.md b/.claude/skills/add_platform/SKILL.md
@@ -1,11 +1,11 @@
 ---
 name: add_platform
-description: "Add a new AI platform to DeepWork with adapter, templates, and tests"
+description: "Adds a new AI platform to DeepWork with adapter, templates, and tests. Use when integrating Cursor, Windsurf, or other AI coding tools."
 ---
 
 # add_platform
 
-**Multi-step workflow**: Add a new AI platform to DeepWork with adapter, templates, and tests
+**Multi-step workflow**: Adds a new AI platform to DeepWork with adapter, templates, and tests. Use when integrating Cursor, Windsurf, or other AI coding tools.
 
 > **CRITICAL**: Always invoke steps using the Skill tool. Never copy/paste step instructions directly.
 
@@ -29,10 +29,10 @@ comprehensive test coverage for new functionality.
 
 ## Available Steps
 
-1. **research** - Capture CLI configuration and hooks system documentation for the new platform
-2. **add_capabilities** - Update job schema and adapters with any new hook events the platform supports (requires: research)
-3. **implement** - Add platform adapter, templates, tests with 100% coverage, and README documentation (requires: research, add_capabilities)
-4. **verify** - Set up platform directories and verify deepwork install works correctly (requires: implement)
+1. **research** - Captures CLI configuration and hooks system documentation for the new platform. Use when starting platform integration.
+2. **add_capabilities** - Updates job schema and adapters with any new hook events the platform supports. Use after research to extend DeepWork's hook system. (requires: research)
+3. **implement** - Creates platform adapter, templates, tests with 100% coverage, and README documentation. Use after adding hook capabilities. (requires: research, add_capabilities)
+4. **verify** - Sets up platform directories and verifies deepwork install works correctly. Use after implementation to confirm integration. (requires: implement)
 
 ## Execution Instructions
 
@@ -64,6 +64,13 @@ If user intent is unclear, use AskUserQuestion to clarify:
 - Present available steps as numbered options
 - Let user select the starting point
 
+## Guardrails
+
+- Do NOT copy/paste step instructions directly; always use the Skill tool to invoke steps
+- Do NOT skip steps in the workflow unless the user explicitly requests it
+- Do NOT proceed to the next step if the current step's outputs are incomplete
+- Do NOT make assumptions about user intent; ask for clarification when ambiguous
+
 ## Context Files
 
 - Job definition: `.deepwork/jobs/add_platform/job.yml`
diff --git a/.claude/skills/commit.commit_and_push/SKILL.md b/.claude/skills/commit.commit_and_push/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: commit.commit_and_push
-description: "Verify changed files, commit, and push to remote"
+description: "Verifies changed files, creates commit, and pushes to remote. Use after linting passes to finalize changes."
 user-invocable: false
 hooks:
   Stop:
@@ -20,7 +20,7 @@ hooks:
 
 **Step 3/3** in **commit** workflow
 
-> Run tests, lint, and commit code changes
+> Runs tests, lints code, and commits changes. Use when ready to commit work with quality checks.
 
 ## Prerequisites (Verify First)
 
@@ -29,7 +29,7 @@ Before proceeding, confirm these steps are complete:
 
 ## Instructions
 
-**Goal**: Verify changed files, commit, and push to remote
+**Goal**: Verifies changed files, creates commit, and pushes to remote. Use after linting passes to finalize changes.
 
 # Commit and Push
 
@@ -136,6 +136,13 @@ Use branch format: `deepwork/commit-[instance]-YYYYMMDD`
 **Required outputs**:
 - `changes_committed`
 
+## Guardrails
+
+- Do NOT skip prerequisite verification if this step has dependencies
+- Do NOT produce partial outputs; complete all required outputs before finishing
+- Do NOT proceed without required inputs; ask the user if any are missing
+- Do NOT modify files outside the scope of this step's defined outputs
+
 ## Quality Validation
 
 Stop hooks will automatically validate your work. The loop continues until all criteria pass.

diff --git a/.claude/skills/commit.lint/SKILL.md b/.claude/skills/commit.lint/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: commit.lint
-description: "Format and lint code with ruff using a sub-agent"
+description: "Formats and lints code with ruff using a sub-agent. Use after tests pass to ensure code style compliance."
 user-invocable: false
 hooks:
   Stop:
@@ -19,7 +19,7 @@ hooks:
 
 **Step 2/3** in **commit** workflow
 
-> Run tests, lint, and commit code changes
+> Runs tests, lints code, and commits changes. Use when ready to commit work with quality checks.
 
 ## Prerequisites (Verify First)
 
@@ -28,7 +28,7 @@ Before proceeding, confirm these steps are complete:
 
 ## Instructions
 
-**Goal**: Format and lint code with ruff using a sub-agent
+**Goal**: Formats and lints code with ruff using a sub-agent. Use after tests pass to ensure code style compliance.
 
 # Lint Code
 
@@ -131,6 +131,13 @@ Use branch format: `deepwork/commit-[instance]-YYYYMMDD`
 **Required outputs**:
 - `code_formatted`
 
+## Guardrails
+
+- Do NOT skip prerequisite verification if this step has dependencies
+- Do NOT produce partial outputs; complete all required outputs before finishing
+- Do NOT proceed without required inputs; ask the user if any are missing
+- Do NOT modify files outside the scope of this step's defined outputs
+
 ## Quality Validation
 
 Stop hooks will automatically validate your work. The loop continues until all criteria pass.

diff --git a/.claude/skills/commit.test/SKILL.md b/.claude/skills/commit.test/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: commit.test
-description: "Pull latest code and run the test suite until all tests pass"
+description: "Pulls latest code and runs tests until all pass. Use when starting the commit workflow or re-running tests."
 user-invocable: false
 hooks:
   Stop:
@@ -20,12 +20,12 @@ hooks:
 
 **Step 1/3** in **commit** workflow
 
-> Run tests, lint, and commit code changes
+> Runs tests, lints code, and commits changes. Use when ready to commit work with quality checks.
 
 
 ## Instructions
 
-**Goal**: Pull latest code and run the test suite until all tests pass
+**Goal**: Pulls latest code and runs tests until all pass. Use when starting the commit workflow or re-running tests.
 
 # Run Tests
 
@@ -114,6 +114,13 @@ Use branch format: `deepwork/commit-[instance]-YYYYMMDD`
 **Required outputs**:
 - `tests_passing`
 
+## Guardrails
+
+- Do NOT skip prerequisite verification if this step has dependencies
+- Do NOT produce partial outputs; complete all required outputs before finishing
+- Do NOT proceed without required inputs; ask the user if any are missing
+- Do NOT modify files outside the scope of this step's defined outputs
+
 ## Quality Validation
 
 Stop hooks will automatically validate your work. The loop continues until all criteria pass.

diff --git a/.claude/skills/commit/SKILL.md b/.claude/skills/commit/SKILL.md
@@ -1,11 +1,11 @@
 ---
 name: commit
-description: "Run tests, lint, and commit code changes"
+description: "Runs tests, lints code, and commits changes. Use when ready to commit work with quality checks."
 ---
 
 # commit
 
-**Multi-step workflow**: Run tests, lint, and commit code changes
+**Multi-step workflow**: Runs tests, lints code, and commits changes. Use when ready to commit work with quality checks.
 
 > **CRITICAL**: Always invoke steps using the Skill tool. Never copy/paste step instructions directly.
 
@@ -23,9 +23,9 @@ Steps:
 
 ## Available Steps
 
-1. **test** - Pull latest code and run the test suite until all tests pass
-2. **lint** - Format and lint code with ruff using a sub-agent (requires: test)
-3. **commit_and_push** - Verify changed files, commit, and push to remote (requires: lint)
+1. **test** - Pulls latest code and runs tests until all pass. Use when starting the commit workflow or re-running tests.
+2. **lint** - Formats and lints code with ruff using a sub-agent. Use after tests pass to ensure code style compliance. (requires: test)
+3. **commit_and_push** - Verifies changed files, creates commit, and pushes to remote. Use after linting passes to finalize changes. (requires: lint)
 
 ## Execution Instructions
 
@@ -56,6 +56,13 @@ If user intent is unclear, use AskUserQuestion to clarify:
 - Present available steps as numbered options
 - Let user select the starting point
 
+## Guardrails
+
+- Do NOT copy/paste step instructions directly; always use the Skill tool to invoke steps
+- Do NOT skip steps in the workflow unless the user explicitly requests it
+- Do NOT proceed to the next step if the current step's outputs are incomplete
+- Do NOT make assumptions about user intent; ask for clarification when ambiguous
+
 ## Context Files
 
 - Job definition: `.deepwork/jobs/commit/job.yml`
diff --git a/.claude/skills/deepwork_jobs.define/SKILL.md b/.claude/skills/deepwork_jobs.define/SKILL.md
@@ -1,6 +1,6 @@
 ---
 name: deepwork_jobs.define
-description: "Create the job.yml specification file by understanding workflow requirements"
+description: "Creates a job.yml specification by gathering workflow requirements through structured questions. Use when starting a new multi-step workflow."
 user-invocable: false
 hooks:
   Stop:
@@ -40,12 +40,12 @@ hooks:
 
 **Step 1/4** in **deepwork_jobs** workflow
 
-> DeepWork job management commands
+> Creates and manages multi-step AI workflows. Use when defining, implementing, or improving DeepWork jobs.
 
 
 ## Instructions
 
-**Goal**: Create the job.yml specification file by understanding workflow requirements
+**Goal**: Creates a job.yml specification by gathering workflow requirements through structured questions. Use when starting a new multi-step workflow.
 
 # Define Job Specification
 
@@ -659,6 +659,13 @@ Use branch format: `deepwork/deepwork_jobs-[instance]-YYYYMMDD`
 
   </details>
 
+## Guardrails
+
+- Do NOT skip prerequisite verification if this step has dependencies
+- Do NOT produce partial outputs; complete all required outputs before finishing
+- Do NOT proceed without required inputs; ask the user if any are missing
+- Do NOT modify files outside the scope of this step's defined outputs
+
 ## Quality Validation
 
 Stop hooks will automatically validate your work. The loop continues until all criteria pass.