From e8961ae5ad2d79146a3a8e8c79ad57aad6c7d2c0 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 23 Jan 2026 16:38:40 +0000 Subject: [PATCH 1/7] Initial plan From b5399c3295b27e1d07c9b87eaff53658e3669e74 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 23 Jan 2026 16:43:36 +0000 Subject: [PATCH 2/7] Add Claude Code plugin structure with install and sync skills Co-authored-by: ncrmro <8276365+ncrmro@users.noreply.github.com> --- .claude-plugin/plugin.json | 19 +++++ PLUGIN.md | 134 ++++++++++++++++++++++++++++++++++ README.md | 25 ++++++- hooks/hooks.json | 46 ++++++++++++ skills/install/SKILL.md | 110 ++++++++++++++++++++++++++++ skills/sync/SKILL.md | 145 +++++++++++++++++++++++++++++++++++++ 6 files changed, 478 insertions(+), 1 deletion(-) create mode 100644 .claude-plugin/plugin.json create mode 100644 PLUGIN.md create mode 100644 hooks/hooks.json create mode 100644 skills/install/SKILL.md create mode 100644 skills/sync/SKILL.md diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json new file mode 100644 index 00000000..e010610f --- /dev/null +++ b/.claude-plugin/plugin.json @@ -0,0 +1,19 @@ +{ + "name": "deepwork", + "version": "0.5.2", + "description": "Framework for enabling AI agents to perform complex, multi-step work tasks", + "author": "DeepWork Contributors", + "homepage": "https://github.com/Unsupervisedcom/deepwork", + "license": "Business Source License 1.1", + "repository": { + "type": "git", + "url": "https://github.com/Unsupervisedcom/deepwork" + }, + "keywords": [ + "ai", + "agents", + "workflow", + "automation", + "multi-step" + ] +} diff --git a/PLUGIN.md b/PLUGIN.md new file mode 100644 index 00000000..f65e8409 --- /dev/null +++ b/PLUGIN.md @@ -0,0 +1,134 @@ +# DeepWork Claude Code Plugin + +This directory contains the Claude Code plugin distribution for DeepWork. + +## About + +DeepWork is a framework for enabling AI agents to perform complex, multi-step work tasks. This plugin provides seamless integration with Claude Code through namespaced skills and automated hooks. + +## Installation + +### Using Plugin Directory Flag (Development/Testing) + +```bash +claude --plugin-dir /path/to/deepwork +``` + +### From GitHub Repository + +```bash +# Install from GitHub +claude plugin install https://github.com/Unsupervisedcom/deepwork +``` + +### From Local Clone + +```bash +# Clone the repository +git clone https://github.com/Unsupervisedcom/deepwork +cd deepwork + +# Install as plugin +claude plugin install . +``` + +## Plugin Structure + +``` +deepwork/ +├── .claude-plugin/ +│ └── plugin.json # Plugin manifest +├── skills/ +│ ├── install/SKILL.md # /deepwork:install command +│ └── sync/SKILL.md # /deepwork:sync command +└── hooks/ + └── hooks.json # Event hooks configuration +``` + +## Available Skills + +After installation, the following skills are available: + +### `/deepwork:install` +Install DeepWork in a project. Adds AI platform support and syncs commands for configured platforms. + +**Usage:** +``` +/deepwork:install +``` + +This will: +- Check for Git repository +- Auto-detect available AI platforms +- Create `.deepwork/` directory structure +- Install core job definitions +- Generate platform-specific skills +- Configure hooks for rules enforcement + +### `/deepwork:sync` +Sync DeepWork job definitions to platform-specific skills. + +**Usage:** +``` +/deepwork:sync +``` + +This will: +- Read configuration from `.deepwork/config.yml` +- Scan all jobs in `.deepwork/jobs/` +- Generate skills for each configured platform +- Update hooks in platform settings + +## Hooks + +The plugin automatically configures the following hooks: + +- **SessionStart**: Version check +- **UserPromptSubmit**: Rules queue management +- **Stop/SubagentStop**: Rules validation + +## Requirements + +- Python 3.11 or higher +- Git repository +- DeepWork CLI tool installed (`pip install deepwork`) + +## Prerequisites + +Before using the plugin, install the DeepWork CLI tool: + +```bash +# Using pipx (recommended) +pipx install deepwork + +# Or using pip +pip install deepwork + +# Or using uv +uv tool install deepwork +``` + +## Next Steps + +1. Use `/deepwork:install` to set up DeepWork in your project +2. Define your first job with `/deepwork_jobs.define` +3. Implement the job with `/deepwork_jobs.implement` +4. Run job steps with `/your_job_name.step_name` + +## Documentation + +- [Main README](../README.md) +- [Architecture](../doc/architecture.md) +- [Contributing](../CONTRIBUTING.md) +- [License](../LICENSE.md) + +## Support + +- Issues: https://github.com/Unsupervisedcom/deepwork/issues +- Documentation: https://github.com/Unsupervisedcom/deepwork#readme + +## License + +Business Source License 1.1 (BSL 1.1) + +See [LICENSE.md](../LICENSE.md) for details. diff --git a/README.md b/README.md index 04cfd86d..2b75ed25 100644 --- a/README.md +++ b/README.md @@ -18,6 +18,19 @@ DeepWork is a tool for defining and executing multi-step workflows with AI codin > **Tip:** New to DeepWork? Claude Code has the most complete feature support, including quality validation hooks and automated rules. For browser automation, Claude in Chrome (Anthropic's browser extension) works well with DeepWork workflows. ## Easy Installation + +### Option 1: Claude Code Plugin (Recommended) + +For Claude Code users, install DeepWork as a plugin: + +```bash +claude plugin install https://github.com/Unsupervisedcom/deepwork +``` + +Then use `/deepwork:install` to set up your project. + +### Option 2: CLI Tool Installation + In your Agent CLI (ex. `claude`), ask: ``` @@ -26,7 +39,6 @@ Please fully install https://pypi.org/project/deepwork/ and make sure you see th ## Installation Details - **Agents**: - be sure to perform all the steps, not just the package install. ### Prerequisites @@ -201,6 +213,17 @@ your-project/ **Note**: Work outputs are created on dedicated Git branches (e.g., `deepwork/job_name-instance-date`), not in a separate directory. +## Plugin Distribution + +DeepWork is available as a Claude Code plugin for seamless integration: + +**Plugin Structure**: +- `.claude-plugin/plugin.json` - Plugin manifest with metadata +- `skills/` - Plugin skills (/deepwork:install, /deepwork:sync) +- `hooks/` - Event hooks configuration + +**Installation**: See [PLUGIN.md](PLUGIN.md) for plugin-specific documentation. + ## Documentation - **[Architecture](doc/architecture.md)**: Complete design specification diff --git a/hooks/hooks.json b/hooks/hooks.json new file mode 100644 index 00000000..5469b3d0 --- /dev/null +++ b/hooks/hooks.json @@ -0,0 +1,46 @@ +{ + "SessionStart": [ + { + "matcher": "", + "hooks": [ + { + "type": "command", + "command": "src/deepwork/hooks/check_version.sh" + } + ] + } + ], + "UserPromptSubmit": [ + { + "matcher": "", + "hooks": [ + { + "type": "command", + "command": ".deepwork/jobs/deepwork_rules/hooks/user_prompt_submit.sh" + } + ] + } + ], + "Stop": [ + { + "matcher": "", + "hooks": [ + { + "type": "command", + "command": "python -m deepwork.hooks.rules_check" + } + ] + } + ], + "SubagentStop": [ + { + "matcher": "", + "hooks": [ + { + "type": "command", + "command": "python -m deepwork.hooks.rules_check" + } + ] + } + ] +} diff --git a/skills/install/SKILL.md b/skills/install/SKILL.md new file mode 100644 index 00000000..f185eb76 --- /dev/null +++ b/skills/install/SKILL.md @@ -0,0 +1,110 @@ +--- +name: install +description: Install DeepWork in a project. Adds AI platform support and syncs commands for configured platforms. Use when setting up DeepWork in a new or existing project. +--- + +# DeepWork Install + +Install DeepWork in a project with support for AI platforms like Claude Code or Gemini CLI. + +## Usage + +This skill wraps the `deepwork install` CLI command and provides an interactive installation experience. + +### Basic Installation + +To install DeepWork with auto-detection: + +```bash +deepwork install +``` + +This will: +1. Check for Git repository +2. Auto-detect available AI platforms (Claude Code, Gemini CLI, etc.) +3. Create `.deepwork/` directory structure +4. Install core job definitions (deepwork_jobs, deepwork_rules) +5. Generate platform-specific skills +6. Configure hooks for rules enforcement + +### Specify Platform + +To install for a specific platform: + +```bash +# For Claude Code +deepwork install --platform claude + +# For Gemini CLI +deepwork install --platform gemini +``` + +### Custom Path + +To install in a specific directory: + +```bash +deepwork install --path /path/to/project +``` + +## What Gets Installed + +After installation, your project will have: + +``` +your-project/ +├── .deepwork/ +│ ├── config.yml # Platform configuration +│ ├── .gitignore # Ignores runtime artifacts +│ ├── tmp/ # Temporary state (gitignored) +│ │ └── .gitkeep +│ ├── rules/ # Rule definitions +│ │ └── README.md # Rules documentation +│ ├── doc_specs/ # Document specifications +│ └── jobs/ # Job definitions +│ ├── deepwork_jobs/ # Core job management +│ └── deepwork_rules/ # Rules management +├── .claude/ # Claude Code skills (if detected) +│ ├── settings.json # Hooks configuration +│ └── skills/ +│ ├── deepwork_jobs.define.md +│ ├── deepwork_jobs.implement.md +│ └── ... +└── .gemini/ # Gemini CLI skills (if detected) + └── skills/ + └── ... +``` + +## Next Steps + +After installation: + +1. Start your AI agent CLI (e.g., `claude` or `gemini`) +2. Define your first job with `/deepwork_jobs.define` +3. Implement the job with `/deepwork_jobs.implement` +4. Run job steps with `/your_job_name.step_name` + +## Requirements + +- Python 3.11 or higher +- Git repository +- One of: Claude Code, Gemini CLI, or other supported platform + +## Troubleshooting + +**"Not a Git repository" error**: +- Run `git init` in your project directory first + +**Platform not detected**: +- Ensure `.claude/` or `.gemini/` directory exists +- Or specify the platform explicitly: `--platform claude` + +**Permission errors**: +- Ensure you have write access to the project directory +- Check that Python/pipx/uv installation is in your PATH + +## Related Commands + +- `/deepwork:sync` - Sync job definitions to platform skills +- `/deepwork_jobs.define` - Define a new multi-step job +- `/deepwork_rules.define` - Define automated rules diff --git a/skills/sync/SKILL.md b/skills/sync/SKILL.md new file mode 100644 index 00000000..7aeea176 --- /dev/null +++ b/skills/sync/SKILL.md @@ -0,0 +1,145 @@ +--- +name: sync +description: Sync DeepWork job definitions to platform-specific skills. Use after modifying job definitions, adding new jobs, or changing platform configurations. +--- + +# DeepWork Sync + +Synchronize job definitions from `.deepwork/jobs/` to platform-specific skills and commands. + +## Usage + +This skill wraps the `deepwork sync` CLI command and regenerates all skills for configured platforms. + +### Basic Sync + +To sync all jobs for all configured platforms: + +```bash +deepwork sync +``` + +This will: +1. Read configuration from `.deepwork/config.yml` +2. Scan all jobs in `.deepwork/jobs/` +3. Generate skills for each configured platform +4. Update hooks in platform settings + +### Custom Path + +To sync a project in a specific directory: + +```bash +deepwork sync --path /path/to/project +``` + +## When to Use Sync + +Run `deepwork sync` when you: + +- **Created a new job** with `/deepwork_jobs.define` and `/deepwork_jobs.implement` +- **Modified a job definition** (`job.yml` or step instructions) +- **Updated job hooks** (quality criteria, validation scripts) +- **Changed platform configuration** in `.deepwork/config.yml` +- **Added a new platform** to the project +- **Updated DeepWork** to a newer version + +## What Gets Synced + +The sync command processes: + +### Job Definitions +- Reads all `job.yml` files from `.deepwork/jobs/*/job.yml` +- Parses step metadata (inputs, outputs, dependencies) +- Reads step instruction files +- Extracts quality criteria and hooks + +### Platform Skills +For each platform, generates: + +**Claude Code** (`.claude/skills/*.md`): +- Step skills: `/job_name.step_name` +- Meta skills: `/deepwork_jobs.*`, `/deepwork_rules.*` +- Frontmatter with hooks configuration +- Quality validation prompts + +**Gemini CLI** (`.gemini/skills/*/tool.toml`): +- Step commands in TOML format +- Job metadata and instructions +- Input/output specifications + +### Hooks +Updates platform settings with: +- Stop hooks for quality validation +- Pre/Post hooks for rules checking +- Command hooks for automated actions + +## Generated Structure + +After sync, you'll have updated: + +``` +.claude/ +├── settings.json # Updated with hooks +└── skills/ + ├── job_name.step_1.md + ├── job_name.step_2.md + └── ... + +.gemini/ +└── skills/ + └── job_name/ + ├── step_1.toml + └── step_2.toml +``` + +## Verify Sync + +After running sync: + +1. **Check skill files exist**: Look in `.claude/skills/` or `.gemini/skills/` +2. **Try invoking a skill**: e.g., `/deepwork_jobs.define` +3. **Check hooks**: View `.claude/settings.json` for hook configurations + +## Troubleshooting + +**"No jobs found" warning**: +- Ensure `.deepwork/jobs/` directory exists +- Check that job directories contain `job.yml` files +- Verify job YAML is valid + +**Skills not appearing**: +- Restart your AI agent CLI after sync +- Check `.deepwork/config.yml` has correct platform names +- Verify platform directories exist (`.claude/`, `.gemini/`) + +**Invalid job definition errors**: +- Review job.yml syntax against schema +- Check step IDs are unique +- Ensure all dependencies reference valid step IDs +- Validate YAML with: `python -c "import yaml; yaml.safe_load(open('.deepwork/jobs/my_job/job.yml'))"` + +**Hooks not working**: +- Confirm hooks are defined in `job.yml` or step instructions +- Check `.claude/settings.json` was updated +- Restart Claude Code to reload settings + +## Advanced Usage + +### Sync Specific Job +While the sync command processes all jobs, you can: +1. Temporarily move other jobs out of `.deepwork/jobs/` +2. Run sync +3. Move them back + +### Add Custom Skills +Standard jobs (like deepwork_jobs) are auto-synced. For custom skills: +1. Create `.deepwork/jobs/my_job/` +2. Add `job.yml` and step instructions +3. Run `deepwork sync` + +## Related Commands + +- `/deepwork:install` - Initial DeepWork setup +- `/deepwork_jobs.implement` - Generate job after defining it +- `/deepwork_rules.define` - Create automated rules From b4e238e6db5c0373166dad4cf489d28707414fad Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 23 Jan 2026 16:44:57 +0000 Subject: [PATCH 3/7] Add commands directory and update plugin documentation Co-authored-by: ncrmro <8276365+ncrmro@users.noreply.github.com> --- PLUGIN.md | 9 ++- README.md | 3 +- commands/install/COMMAND.md | 105 +++++++++++++++++++++++++++ commands/sync/COMMAND.md | 140 ++++++++++++++++++++++++++++++++++++ 4 files changed, 253 insertions(+), 4 deletions(-) create mode 100644 commands/install/COMMAND.md create mode 100644 commands/sync/COMMAND.md diff --git a/PLUGIN.md b/PLUGIN.md index f65e8409..88bd2d05 100644 --- a/PLUGIN.md +++ b/PLUGIN.md @@ -38,14 +38,17 @@ claude plugin install . deepwork/ ├── .claude-plugin/ │ └── plugin.json # Plugin manifest +├── commands/ +│ ├── install/COMMAND.md # /deepwork:install command +│ └── sync/COMMAND.md # /deepwork:sync command ├── skills/ -│ ├── install/SKILL.md # /deepwork:install command -│ └── sync/SKILL.md # /deepwork:sync command +│ ├── install/SKILL.md # Agent skill for auto-detection +│ └── sync/SKILL.md # Agent skill for auto-sync └── hooks/ └── hooks.json # Event hooks configuration ``` -## Available Skills +## Available Commands After installation, the following skills are available: diff --git a/README.md b/README.md index 2b75ed25..ec61155a 100644 --- a/README.md +++ b/README.md @@ -219,7 +219,8 @@ DeepWork is available as a Claude Code plugin for seamless integration: **Plugin Structure**: - `.claude-plugin/plugin.json` - Plugin manifest with metadata -- `skills/` - Plugin skills (/deepwork:install, /deepwork:sync) +- `commands/` - User-invocable commands (/deepwork:install, /deepwork:sync) +- `skills/` - Agent Skills for automatic invocation - `hooks/` - Event hooks configuration **Installation**: See [PLUGIN.md](PLUGIN.md) for plugin-specific documentation. diff --git a/commands/install/COMMAND.md b/commands/install/COMMAND.md new file mode 100644 index 00000000..abe52986 --- /dev/null +++ b/commands/install/COMMAND.md @@ -0,0 +1,105 @@ +# DeepWork Install + +Install DeepWork in a project with support for AI platforms like Claude Code or Gemini CLI. + +## Usage + +This skill wraps the `deepwork install` CLI command and provides an interactive installation experience. + +### Basic Installation + +To install DeepWork with auto-detection: + +```bash +deepwork install +``` + +This will: +1. Check for Git repository +2. Auto-detect available AI platforms (Claude Code, Gemini CLI, etc.) +3. Create `.deepwork/` directory structure +4. Install core job definitions (deepwork_jobs, deepwork_rules) +5. Generate platform-specific skills +6. Configure hooks for rules enforcement + +### Specify Platform + +To install for a specific platform: + +```bash +# For Claude Code +deepwork install --platform claude + +# For Gemini CLI +deepwork install --platform gemini +``` + +### Custom Path + +To install in a specific directory: + +```bash +deepwork install --path /path/to/project +``` + +## What Gets Installed + +After installation, your project will have: + +``` +your-project/ +├── .deepwork/ +│ ├── config.yml # Platform configuration +│ ├── .gitignore # Ignores runtime artifacts +│ ├── tmp/ # Temporary state (gitignored) +│ │ └── .gitkeep +│ ├── rules/ # Rule definitions +│ │ └── README.md # Rules documentation +│ ├── doc_specs/ # Document specifications +│ └── jobs/ # Job definitions +│ ├── deepwork_jobs/ # Core job management +│ └── deepwork_rules/ # Rules management +├── .claude/ # Claude Code skills (if detected) +│ ├── settings.json # Hooks configuration +│ └── skills/ +│ ├── deepwork_jobs.define.md +│ ├── deepwork_jobs.implement.md +│ └── ... +└── .gemini/ # Gemini CLI skills (if detected) + └── skills/ + └── ... +``` + +## Next Steps + +After installation: + +1. Start your AI agent CLI (e.g., `claude` or `gemini`) +2. Define your first job with `/deepwork_jobs.define` +3. Implement the job with `/deepwork_jobs.implement` +4. Run job steps with `/your_job_name.step_name` + +## Requirements + +- Python 3.11 or higher +- Git repository +- One of: Claude Code, Gemini CLI, or other supported platform + +## Troubleshooting + +**"Not a Git repository" error**: +- Run `git init` in your project directory first + +**Platform not detected**: +- Ensure `.claude/` or `.gemini/` directory exists +- Or specify the platform explicitly: `--platform claude` + +**Permission errors**: +- Ensure you have write access to the project directory +- Check that Python/pipx/uv installation is in your PATH + +## Related Commands + +- `/deepwork:sync` - Sync job definitions to platform skills +- `/deepwork_jobs.define` - Define a new multi-step job +- `/deepwork_rules.define` - Define automated rules diff --git a/commands/sync/COMMAND.md b/commands/sync/COMMAND.md new file mode 100644 index 00000000..4c2ac328 --- /dev/null +++ b/commands/sync/COMMAND.md @@ -0,0 +1,140 @@ +# DeepWork Sync + +Synchronize job definitions from `.deepwork/jobs/` to platform-specific skills and commands. + +## Usage + +This skill wraps the `deepwork sync` CLI command and regenerates all skills for configured platforms. + +### Basic Sync + +To sync all jobs for all configured platforms: + +```bash +deepwork sync +``` + +This will: +1. Read configuration from `.deepwork/config.yml` +2. Scan all jobs in `.deepwork/jobs/` +3. Generate skills for each configured platform +4. Update hooks in platform settings + +### Custom Path + +To sync a project in a specific directory: + +```bash +deepwork sync --path /path/to/project +``` + +## When to Use Sync + +Run `deepwork sync` when you: + +- **Created a new job** with `/deepwork_jobs.define` and `/deepwork_jobs.implement` +- **Modified a job definition** (`job.yml` or step instructions) +- **Updated job hooks** (quality criteria, validation scripts) +- **Changed platform configuration** in `.deepwork/config.yml` +- **Added a new platform** to the project +- **Updated DeepWork** to a newer version + +## What Gets Synced + +The sync command processes: + +### Job Definitions +- Reads all `job.yml` files from `.deepwork/jobs/*/job.yml` +- Parses step metadata (inputs, outputs, dependencies) +- Reads step instruction files +- Extracts quality criteria and hooks + +### Platform Skills +For each platform, generates: + +**Claude Code** (`.claude/skills/*.md`): +- Step skills: `/job_name.step_name` +- Meta skills: `/deepwork_jobs.*`, `/deepwork_rules.*` +- Frontmatter with hooks configuration +- Quality validation prompts + +**Gemini CLI** (`.gemini/skills/*/tool.toml`): +- Step commands in TOML format +- Job metadata and instructions +- Input/output specifications + +### Hooks +Updates platform settings with: +- Stop hooks for quality validation +- Pre/Post hooks for rules checking +- Command hooks for automated actions + +## Generated Structure + +After sync, you'll have updated: + +``` +.claude/ +├── settings.json # Updated with hooks +└── skills/ + ├── job_name.step_1.md + ├── job_name.step_2.md + └── ... + +.gemini/ +└── skills/ + └── job_name/ + ├── step_1.toml + └── step_2.toml +``` + +## Verify Sync + +After running sync: + +1. **Check skill files exist**: Look in `.claude/skills/` or `.gemini/skills/` +2. **Try invoking a skill**: e.g., `/deepwork_jobs.define` +3. **Check hooks**: View `.claude/settings.json` for hook configurations + +## Troubleshooting + +**"No jobs found" warning**: +- Ensure `.deepwork/jobs/` directory exists +- Check that job directories contain `job.yml` files +- Verify job YAML is valid + +**Skills not appearing**: +- Restart your AI agent CLI after sync +- Check `.deepwork/config.yml` has correct platform names +- Verify platform directories exist (`.claude/`, `.gemini/`) + +**Invalid job definition errors**: +- Review job.yml syntax against schema +- Check step IDs are unique +- Ensure all dependencies reference valid step IDs +- Validate YAML with: `python -c "import yaml; yaml.safe_load(open('.deepwork/jobs/my_job/job.yml'))"` + +**Hooks not working**: +- Confirm hooks are defined in `job.yml` or step instructions +- Check `.claude/settings.json` was updated +- Restart Claude Code to reload settings + +## Advanced Usage + +### Sync Specific Job +While the sync command processes all jobs, you can: +1. Temporarily move other jobs out of `.deepwork/jobs/` +2. Run sync +3. Move them back + +### Add Custom Skills +Standard jobs (like deepwork_jobs) are auto-synced. For custom skills: +1. Create `.deepwork/jobs/my_job/` +2. Add `job.yml` and step instructions +3. Run `deepwork sync` + +## Related Commands + +- `/deepwork:install` - Initial DeepWork setup +- `/deepwork_jobs.implement` - Generate job after defining it +- `/deepwork_rules.define` - Create automated rules From 3bd4874dbf4204a63334926cd7a31350f3c42edc Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 23 Jan 2026 16:45:48 +0000 Subject: [PATCH 4/7] Add plugin testing documentation and CHANGELOG entry Co-authored-by: ncrmro <8276365+ncrmro@users.noreply.github.com> --- CHANGELOG.md | 10 ++++++++++ PLUGIN.md | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 61 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 1a6a3ce0..809cc619 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,16 @@ All notable changes to DeepWork will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [Unreleased] + +### Added +- Claude Code plugin structure with `.claude-plugin/plugin.json` manifest +- User-invocable commands: `/deepwork:install` and `/deepwork:sync` +- Agent Skills for automatic installation and sync detection +- Plugin hooks configuration in `hooks/hooks.json` +- Comprehensive PLUGIN.md documentation for plugin usage +- README updated with plugin installation instructions + ## [0.5.2] - 2026-01-22 ### Fixed diff --git a/PLUGIN.md b/PLUGIN.md index 88bd2d05..451554f2 100644 --- a/PLUGIN.md +++ b/PLUGIN.md @@ -135,3 +135,54 @@ uv tool install deepwork Business Source License 1.1 (BSL 1.1) See [LICENSE.md](../LICENSE.md) for details. + +## Testing the Plugin Locally + +To test the plugin structure before distribution: + +```bash +# From the DeepWork repository root +claude --plugin-dir /path/to/deepwork + +# In Claude Code, test the commands: +/deepwork:install --help +/deepwork:sync --help +``` + +You should see the commands available with the `deepwork:` namespace prefix. + +## Plugin Development Notes + +### Directory Structure Requirements + +Claude Code plugins must follow this structure: +- `.claude-plugin/plugin.json` (required) - Plugin manifest +- `commands/` (optional) - User-invocable slash commands +- `skills/` (optional) - Agent Skills invoked automatically +- `hooks/` (optional) - Event hooks configuration +- `.mcp.json` (optional) - MCP server configurations +- `.lsp.json` (optional) - LSP server configurations + +### Command Files + +Command files in `commands/[name]/COMMAND.md`: +- Are user-invocable as `/plugin-name:command-name` +- Should NOT have YAML frontmatter +- Should be descriptive markdown with usage examples + +### Skill Files + +Skill files in `skills/[name]/SKILL.md`: +- Have YAML frontmatter with `name` and `description` +- Are invoked automatically by Claude based on context +- Should include clear usage guidelines + +### Hooks Configuration + +The `hooks/hooks.json` file configures event handlers: +- **SessionStart**: Run when Claude Code session begins +- **UserPromptSubmit**: Run when user submits a prompt +- **Stop/SubagentStop**: Run when agent completes a task +- **PreToolUse**: Run before tool invocation +- **PostToolUse**: Run after tool invocation + From 306f66757304af251eb2b8b02dc9d83f8abd41f6 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 23 Jan 2026 16:46:54 +0000 Subject: [PATCH 5/7] Clarify distinction between commands and skills in documentation Co-authored-by: ncrmro <8276365+ncrmro@users.noreply.github.com> --- commands/install/COMMAND.md | 2 +- commands/sync/COMMAND.md | 2 +- skills/install/SKILL.md | 31 ++++++++++++++++++++++++++----- skills/sync/SKILL.md | 32 +++++++++++++++++++++++++++----- 4 files changed, 55 insertions(+), 12 deletions(-) diff --git a/commands/install/COMMAND.md b/commands/install/COMMAND.md index abe52986..b234730b 100644 --- a/commands/install/COMMAND.md +++ b/commands/install/COMMAND.md @@ -4,7 +4,7 @@ Install DeepWork in a project with support for AI platforms like Claude Code or ## Usage -This skill wraps the `deepwork install` CLI command and provides an interactive installation experience. +This command provides an interactive installation experience for setting up DeepWork in your project. ### Basic Installation diff --git a/commands/sync/COMMAND.md b/commands/sync/COMMAND.md index 4c2ac328..e27fc183 100644 --- a/commands/sync/COMMAND.md +++ b/commands/sync/COMMAND.md @@ -4,7 +4,7 @@ Synchronize job definitions from `.deepwork/jobs/` to platform-specific skills a ## Usage -This skill wraps the `deepwork sync` CLI command and regenerates all skills for configured platforms. +This command regenerates all skills for configured platforms after job modifications. ### Basic Sync diff --git a/skills/install/SKILL.md b/skills/install/SKILL.md index f185eb76..dbe7af48 100644 --- a/skills/install/SKILL.md +++ b/skills/install/SKILL.md @@ -3,15 +3,36 @@ name: install description: Install DeepWork in a project. Adds AI platform support and syncs commands for configured platforms. Use when setting up DeepWork in a new or existing project. --- -# DeepWork Install +# DeepWork Install (Agent Skill) -Install DeepWork in a project with support for AI platforms like Claude Code or Gemini CLI. +This agent skill automatically detects when a project needs DeepWork installation and provides guidance. -## Usage +## Automatic Invocation -This skill wraps the `deepwork install` CLI command and provides an interactive installation experience. +Claude will invoke this skill automatically when: +- You mention setting up DeepWork in a new project +- The conversation indicates a need for workflow automation +- You ask about defining multi-step AI workflows -### Basic Installation +## What This Skill Does + +When invoked, this skill: +1. Checks if DeepWork is already installed in the project +2. Provides guidance on running `deepwork install` or `/deepwork:install` +3. Explains what will be set up (directory structure, jobs, hooks) +4. Suggests next steps after installation + +## Manual Command + +Users can also explicitly run the installation command: +``` +/deepwork:install +``` + +## Related + +- **Command**: `/deepwork:install` - User-invocable command for installation +- **CLI**: `deepwork install` - Direct CLI tool invocation To install DeepWork with auto-detection: diff --git a/skills/sync/SKILL.md b/skills/sync/SKILL.md index 7aeea176..033b825f 100644 --- a/skills/sync/SKILL.md +++ b/skills/sync/SKILL.md @@ -3,15 +3,37 @@ name: sync description: Sync DeepWork job definitions to platform-specific skills. Use after modifying job definitions, adding new jobs, or changing platform configurations. --- -# DeepWork Sync +# DeepWork Sync (Agent Skill) -Synchronize job definitions from `.deepwork/jobs/` to platform-specific skills and commands. +This agent skill automatically detects when job definitions need to be synced to platform skills. -## Usage +## Automatic Invocation -This skill wraps the `deepwork sync` CLI command and regenerates all skills for configured platforms. +Claude will invoke this skill automatically when: +- Job definitions are modified in `.deepwork/jobs/` +- New jobs are created with `/deepwork_jobs.implement` +- Platform configuration changes are detected +- Step instructions or hooks are updated -### Basic Sync +## What This Skill Does + +When invoked, this skill: +1. Detects changes to job definitions +2. Identifies which platforms need skill regeneration +3. Provides guidance on running `deepwork sync` or `/deepwork:sync` +4. Explains what will be updated (skills, hooks, platform settings) + +## Manual Command + +Users can also explicitly run the sync command: +``` +/deepwork:sync +``` + +## Related + +- **Command**: `/deepwork:sync` - User-invocable command for syncing +- **CLI**: `deepwork sync` - Direct CLI tool invocation To sync all jobs for all configured platforms: From 0fc71142d7d0948768f186171722dbf04022c790 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 26 Jan 2026 16:48:29 +0000 Subject: [PATCH 6/7] Remove commands directory and update to skills-only architecture per Claude Code changes Co-authored-by: nhorton <204146+nhorton@users.noreply.github.com> --- AGENTS.md | 34 +++++++++ CHANGELOG.md | 10 ++- PLUGIN.md | 34 ++++----- README.md | 5 +- commands/install/COMMAND.md | 105 --------------------------- commands/sync/COMMAND.md | 140 ------------------------------------ skills/install/SKILL.md | 31 ++------ skills/sync/SKILL.md | 32 ++------- 8 files changed, 67 insertions(+), 324 deletions(-) delete mode 100644 commands/install/COMMAND.md delete mode 100644 commands/sync/COMMAND.md diff --git a/AGENTS.md b/AGENTS.md index 2c34acf4..14675443 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -2,6 +2,40 @@ This file contains critical instructions for AI agents working on this codebase. +## Claude Code Plugin Architecture + +**IMPORTANT**: Claude Code has retired the separate "commands" concept. Skills are now directly invocable with slash commands (e.g., `/plugin-name:skill-name`). + +### Plugin Structure + +DeepWork is distributed as a Claude Code plugin with the following structure: + +``` +.claude-plugin/ +└── plugin.json # Plugin manifest + +skills/ +├── install/SKILL.md # /deepwork:install +└── sync/SKILL.md # /deepwork:sync + +hooks/ +└── hooks.json # Event hooks configuration +``` + +### Skills vs Commands + +- **Previous approach**: Separate `commands/` and `skills/` directories where commands were user-invocable and skills were agent-invocable +- **Current approach**: Only `skills/` directory, where all skills can be both user-invoked with slash commands AND automatically invoked by Claude based on context +- Skills are invoked as `/deepwork:skill-name` (e.g., `/deepwork:install`, `/deepwork:sync`) + +### When Creating Plugin Skills + +- Place all skills in `skills/[skill-name]/SKILL.md` +- Use YAML frontmatter with `name` and `description` +- Skills will be namespaced as `/deepwork:skill-name` +- Claude can invoke them automatically OR users can invoke them with slash commands +- Do NOT create a separate `commands/` directory + ## CRITICAL: Job Type Classification When creating or modifying jobs in this repository, you MUST understand which type of job you are working with. There are exactly **three types of jobs**, each with a specific location and purpose. diff --git a/CHANGELOG.md b/CHANGELOG.md index 809cc619..1b79fc5f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,11 +9,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ### Added - Claude Code plugin structure with `.claude-plugin/plugin.json` manifest -- User-invocable commands: `/deepwork:install` and `/deepwork:sync` -- Agent Skills for automatic installation and sync detection +- Plugin skills: `/deepwork:install` and `/deepwork:sync` (invocable by users and automatically by Claude) - Plugin hooks configuration in `hooks/hooks.json` - Comprehensive PLUGIN.md documentation for plugin usage -- README updated with plugin installation instructions +- AGENTS.md section documenting Claude Code plugin architecture + +### Changed +- **Architecture**: Removed separate `commands/` directory following Claude Code's retirement of commands in favor of skills +- Skills in `skills/` directory now serve dual purpose: user-invocable with slash commands AND automatic invocation by Claude +- Documentation updated to reflect unified skill approach ## [0.5.2] - 2026-01-22 diff --git a/PLUGIN.md b/PLUGIN.md index 451554f2..c3ae3836 100644 --- a/PLUGIN.md +++ b/PLUGIN.md @@ -38,19 +38,16 @@ claude plugin install . deepwork/ ├── .claude-plugin/ │ └── plugin.json # Plugin manifest -├── commands/ -│ ├── install/COMMAND.md # /deepwork:install command -│ └── sync/COMMAND.md # /deepwork:sync command ├── skills/ -│ ├── install/SKILL.md # Agent skill for auto-detection -│ └── sync/SKILL.md # Agent skill for auto-sync +│ ├── install/SKILL.md # /deepwork:install skill +│ └── sync/SKILL.md # /deepwork:sync skill └── hooks/ └── hooks.json # Event hooks configuration ``` -## Available Commands +## Available Skills -After installation, the following skills are available: +After installation, the following skills are available and can be invoked with slash commands: ### `/deepwork:install` Install DeepWork in a project. Adds AI platform support and syncs commands for configured platforms. @@ -144,12 +141,12 @@ To test the plugin structure before distribution: # From the DeepWork repository root claude --plugin-dir /path/to/deepwork -# In Claude Code, test the commands: -/deepwork:install --help -/deepwork:sync --help +# In Claude Code, test the skills with slash commands: +/deepwork:install +/deepwork:sync ``` -You should see the commands available with the `deepwork:` namespace prefix. +You should see the skills available with the `deepwork:` namespace prefix. ## Plugin Development Notes @@ -157,25 +154,20 @@ You should see the commands available with the `deepwork:` namespace prefix. Claude Code plugins must follow this structure: - `.claude-plugin/plugin.json` (required) - Plugin manifest -- `commands/` (optional) - User-invocable slash commands -- `skills/` (optional) - Agent Skills invoked automatically +- `skills/` (optional) - Skills invocable with slash commands and by Claude automatically - `hooks/` (optional) - Event hooks configuration - `.mcp.json` (optional) - MCP server configurations - `.lsp.json` (optional) - LSP server configurations -### Command Files - -Command files in `commands/[name]/COMMAND.md`: -- Are user-invocable as `/plugin-name:command-name` -- Should NOT have YAML frontmatter -- Should be descriptive markdown with usage examples +**Note**: Claude Code has retired the separate `commands/` directory. Skills now serve both purposes - they can be invoked by users with slash commands (e.g., `/deepwork:install`) AND automatically by Claude based on context. ### Skill Files Skill files in `skills/[name]/SKILL.md`: - Have YAML frontmatter with `name` and `description` -- Are invoked automatically by Claude based on context -- Should include clear usage guidelines +- Are invoked as `/plugin-name:skill-name` by users +- Can also be invoked automatically by Claude based on context +- Should include clear usage guidelines and examples ### Hooks Configuration diff --git a/README.md b/README.md index ec61155a..3e69d218 100644 --- a/README.md +++ b/README.md @@ -219,10 +219,11 @@ DeepWork is available as a Claude Code plugin for seamless integration: **Plugin Structure**: - `.claude-plugin/plugin.json` - Plugin manifest with metadata -- `commands/` - User-invocable commands (/deepwork:install, /deepwork:sync) -- `skills/` - Agent Skills for automatic invocation +- `skills/` - Skills invocable with `/deepwork:install`, `/deepwork:sync` and automatically by Claude - `hooks/` - Event hooks configuration +**Note**: Claude Code has retired the separate `commands/` directory. Skills now serve both purposes - user-invocable with slash commands AND automatically invokable by Claude. + **Installation**: See [PLUGIN.md](PLUGIN.md) for plugin-specific documentation. ## Documentation diff --git a/commands/install/COMMAND.md b/commands/install/COMMAND.md deleted file mode 100644 index b234730b..00000000 --- a/commands/install/COMMAND.md +++ /dev/null @@ -1,105 +0,0 @@ -# DeepWork Install - -Install DeepWork in a project with support for AI platforms like Claude Code or Gemini CLI. - -## Usage - -This command provides an interactive installation experience for setting up DeepWork in your project. - -### Basic Installation - -To install DeepWork with auto-detection: - -```bash -deepwork install -``` - -This will: -1. Check for Git repository -2. Auto-detect available AI platforms (Claude Code, Gemini CLI, etc.) -3. Create `.deepwork/` directory structure -4. Install core job definitions (deepwork_jobs, deepwork_rules) -5. Generate platform-specific skills -6. Configure hooks for rules enforcement - -### Specify Platform - -To install for a specific platform: - -```bash -# For Claude Code -deepwork install --platform claude - -# For Gemini CLI -deepwork install --platform gemini -``` - -### Custom Path - -To install in a specific directory: - -```bash -deepwork install --path /path/to/project -``` - -## What Gets Installed - -After installation, your project will have: - -``` -your-project/ -├── .deepwork/ -│ ├── config.yml # Platform configuration -│ ├── .gitignore # Ignores runtime artifacts -│ ├── tmp/ # Temporary state (gitignored) -│ │ └── .gitkeep -│ ├── rules/ # Rule definitions -│ │ └── README.md # Rules documentation -│ ├── doc_specs/ # Document specifications -│ └── jobs/ # Job definitions -│ ├── deepwork_jobs/ # Core job management -│ └── deepwork_rules/ # Rules management -├── .claude/ # Claude Code skills (if detected) -│ ├── settings.json # Hooks configuration -│ └── skills/ -│ ├── deepwork_jobs.define.md -│ ├── deepwork_jobs.implement.md -│ └── ... -└── .gemini/ # Gemini CLI skills (if detected) - └── skills/ - └── ... -``` - -## Next Steps - -After installation: - -1. Start your AI agent CLI (e.g., `claude` or `gemini`) -2. Define your first job with `/deepwork_jobs.define` -3. Implement the job with `/deepwork_jobs.implement` -4. Run job steps with `/your_job_name.step_name` - -## Requirements - -- Python 3.11 or higher -- Git repository -- One of: Claude Code, Gemini CLI, or other supported platform - -## Troubleshooting - -**"Not a Git repository" error**: -- Run `git init` in your project directory first - -**Platform not detected**: -- Ensure `.claude/` or `.gemini/` directory exists -- Or specify the platform explicitly: `--platform claude` - -**Permission errors**: -- Ensure you have write access to the project directory -- Check that Python/pipx/uv installation is in your PATH - -## Related Commands - -- `/deepwork:sync` - Sync job definitions to platform skills -- `/deepwork_jobs.define` - Define a new multi-step job -- `/deepwork_rules.define` - Define automated rules diff --git a/commands/sync/COMMAND.md b/commands/sync/COMMAND.md deleted file mode 100644 index e27fc183..00000000 --- a/commands/sync/COMMAND.md +++ /dev/null @@ -1,140 +0,0 @@ -# DeepWork Sync - -Synchronize job definitions from `.deepwork/jobs/` to platform-specific skills and commands. - -## Usage - -This command regenerates all skills for configured platforms after job modifications. - -### Basic Sync - -To sync all jobs for all configured platforms: - -```bash -deepwork sync -``` - -This will: -1. Read configuration from `.deepwork/config.yml` -2. Scan all jobs in `.deepwork/jobs/` -3. Generate skills for each configured platform -4. Update hooks in platform settings - -### Custom Path - -To sync a project in a specific directory: - -```bash -deepwork sync --path /path/to/project -``` - -## When to Use Sync - -Run `deepwork sync` when you: - -- **Created a new job** with `/deepwork_jobs.define` and `/deepwork_jobs.implement` -- **Modified a job definition** (`job.yml` or step instructions) -- **Updated job hooks** (quality criteria, validation scripts) -- **Changed platform configuration** in `.deepwork/config.yml` -- **Added a new platform** to the project -- **Updated DeepWork** to a newer version - -## What Gets Synced - -The sync command processes: - -### Job Definitions -- Reads all `job.yml` files from `.deepwork/jobs/*/job.yml` -- Parses step metadata (inputs, outputs, dependencies) -- Reads step instruction files -- Extracts quality criteria and hooks - -### Platform Skills -For each platform, generates: - -**Claude Code** (`.claude/skills/*.md`): -- Step skills: `/job_name.step_name` -- Meta skills: `/deepwork_jobs.*`, `/deepwork_rules.*` -- Frontmatter with hooks configuration -- Quality validation prompts - -**Gemini CLI** (`.gemini/skills/*/tool.toml`): -- Step commands in TOML format -- Job metadata and instructions -- Input/output specifications - -### Hooks -Updates platform settings with: -- Stop hooks for quality validation -- Pre/Post hooks for rules checking -- Command hooks for automated actions - -## Generated Structure - -After sync, you'll have updated: - -``` -.claude/ -├── settings.json # Updated with hooks -└── skills/ - ├── job_name.step_1.md - ├── job_name.step_2.md - └── ... - -.gemini/ -└── skills/ - └── job_name/ - ├── step_1.toml - └── step_2.toml -``` - -## Verify Sync - -After running sync: - -1. **Check skill files exist**: Look in `.claude/skills/` or `.gemini/skills/` -2. **Try invoking a skill**: e.g., `/deepwork_jobs.define` -3. **Check hooks**: View `.claude/settings.json` for hook configurations - -## Troubleshooting - -**"No jobs found" warning**: -- Ensure `.deepwork/jobs/` directory exists -- Check that job directories contain `job.yml` files -- Verify job YAML is valid - -**Skills not appearing**: -- Restart your AI agent CLI after sync -- Check `.deepwork/config.yml` has correct platform names -- Verify platform directories exist (`.claude/`, `.gemini/`) - -**Invalid job definition errors**: -- Review job.yml syntax against schema -- Check step IDs are unique -- Ensure all dependencies reference valid step IDs -- Validate YAML with: `python -c "import yaml; yaml.safe_load(open('.deepwork/jobs/my_job/job.yml'))"` - -**Hooks not working**: -- Confirm hooks are defined in `job.yml` or step instructions -- Check `.claude/settings.json` was updated -- Restart Claude Code to reload settings - -## Advanced Usage - -### Sync Specific Job -While the sync command processes all jobs, you can: -1. Temporarily move other jobs out of `.deepwork/jobs/` -2. Run sync -3. Move them back - -### Add Custom Skills -Standard jobs (like deepwork_jobs) are auto-synced. For custom skills: -1. Create `.deepwork/jobs/my_job/` -2. Add `job.yml` and step instructions -3. Run `deepwork sync` - -## Related Commands - -- `/deepwork:install` - Initial DeepWork setup -- `/deepwork_jobs.implement` - Generate job after defining it -- `/deepwork_rules.define` - Create automated rules diff --git a/skills/install/SKILL.md b/skills/install/SKILL.md index dbe7af48..793c8e9a 100644 --- a/skills/install/SKILL.md +++ b/skills/install/SKILL.md @@ -3,36 +3,15 @@ name: install description: Install DeepWork in a project. Adds AI platform support and syncs commands for configured platforms. Use when setting up DeepWork in a new or existing project. --- -# DeepWork Install (Agent Skill) +# DeepWork Install -This agent skill automatically detects when a project needs DeepWork installation and provides guidance. +Install DeepWork in a project with support for AI platforms like Claude Code or Gemini CLI. -## Automatic Invocation +## Usage -Claude will invoke this skill automatically when: -- You mention setting up DeepWork in a new project -- The conversation indicates a need for workflow automation -- You ask about defining multi-step AI workflows +This skill can be invoked with `/deepwork:install` or Claude may invoke it automatically when detecting a need for DeepWork setup. -## What This Skill Does - -When invoked, this skill: -1. Checks if DeepWork is already installed in the project -2. Provides guidance on running `deepwork install` or `/deepwork:install` -3. Explains what will be set up (directory structure, jobs, hooks) -4. Suggests next steps after installation - -## Manual Command - -Users can also explicitly run the installation command: -``` -/deepwork:install -``` - -## Related - -- **Command**: `/deepwork:install` - User-invocable command for installation -- **CLI**: `deepwork install` - Direct CLI tool invocation +### Basic Installation To install DeepWork with auto-detection: diff --git a/skills/sync/SKILL.md b/skills/sync/SKILL.md index 033b825f..437a293d 100644 --- a/skills/sync/SKILL.md +++ b/skills/sync/SKILL.md @@ -3,37 +3,15 @@ name: sync description: Sync DeepWork job definitions to platform-specific skills. Use after modifying job definitions, adding new jobs, or changing platform configurations. --- -# DeepWork Sync (Agent Skill) +# DeepWork Sync -This agent skill automatically detects when job definitions need to be synced to platform skills. +Synchronize job definitions from `.deepwork/jobs/` to platform-specific skills and commands. -## Automatic Invocation +## Usage -Claude will invoke this skill automatically when: -- Job definitions are modified in `.deepwork/jobs/` -- New jobs are created with `/deepwork_jobs.implement` -- Platform configuration changes are detected -- Step instructions or hooks are updated +This skill can be invoked with `/deepwork:sync` or Claude may invoke it automatically when detecting changes to job definitions. -## What This Skill Does - -When invoked, this skill: -1. Detects changes to job definitions -2. Identifies which platforms need skill regeneration -3. Provides guidance on running `deepwork sync` or `/deepwork:sync` -4. Explains what will be updated (skills, hooks, platform settings) - -## Manual Command - -Users can also explicitly run the sync command: -``` -/deepwork:sync -``` - -## Related - -- **Command**: `/deepwork:sync` - User-invocable command for syncing -- **CLI**: `deepwork sync` - Direct CLI tool invocation +### Basic Sync To sync all jobs for all configured platforms: From ff1413d5ce8b99ea81ebffb4ceea75577eacc203 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 26 Jan 2026 16:49:24 +0000 Subject: [PATCH 7/7] Fix skill descriptions to use 'skills' instead of 'commands' terminology Co-authored-by: nhorton <204146+nhorton@users.noreply.github.com> --- skills/install/SKILL.md | 2 +- skills/sync/SKILL.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/skills/install/SKILL.md b/skills/install/SKILL.md index 793c8e9a..7db44bda 100644 --- a/skills/install/SKILL.md +++ b/skills/install/SKILL.md @@ -1,6 +1,6 @@ --- name: install -description: Install DeepWork in a project. Adds AI platform support and syncs commands for configured platforms. Use when setting up DeepWork in a new or existing project. +description: Install DeepWork in a project. Adds AI platform support and syncs skills for configured platforms. Use when setting up DeepWork in a new or existing project. --- # DeepWork Install diff --git a/skills/sync/SKILL.md b/skills/sync/SKILL.md index 437a293d..aa10054a 100644 --- a/skills/sync/SKILL.md +++ b/skills/sync/SKILL.md @@ -5,7 +5,7 @@ description: Sync DeepWork job definitions to platform-specific skills. Use afte # DeepWork Sync -Synchronize job definitions from `.deepwork/jobs/` to platform-specific skills and commands. +Synchronize job definitions from `.deepwork/jobs/` to platform-specific skills. ## Usage