Skip to content

Conversation

@nhorton
Copy link
Contributor

@nhorton nhorton commented Jan 26, 2026

Summary

This PR adds a new clone_remote_job skill to the DeepWork job management system, enabling users to install pre-built jobs from GitHub repositories (such as the DeepWork job library) and customize them for their projects.

Key Changes

  • New Skill: Added deepwork_jobs.clone_remote_job as a standalone skill that can be invoked anytime

    • Guides users through installing jobs from remote GitHub repositories
    • Handles customization of installed jobs for project-specific needs
    • Includes comprehensive quality criteria validation
  • Installation Script: Created .deepwork/jobs/deepwork_jobs/install_remote_job.sh

    • Downloads job files from GitHub using the GitHub API
    • Supports recursive directory downloads
    • Validates dependencies (curl, jq) and provides installation guidance
    • Handles error cases (rate limiting, invalid URLs, missing paths)
    • Includes debug mode for troubleshooting
  • Documentation: Added comprehensive skill documentation

    • Step-by-step instructions for job installation and customization
    • Example dialog showing typical workflow
    • Quality criteria for validation
    • Output format specifications
  • Integration: Updated existing skills and configuration

    • Updated deepwork_jobs parent skill to reference the new command
    • Updated step numbering (now 1/5 instead of 1/4) across all skills
    • Updated job context descriptions to mention remote job installation
    • Added skill to settings.json permissions
    • Updated job.yml version to 0.10.0 with changelog entry
  • Multi-Platform Support: Generated skill definitions for both Claude and Gemini CLI

    • Added .claude/skills/deepwork_jobs.clone_remote_job/SKILL.md
    • Added .gemini/skills/deepwork_jobs/clone_remote_job.toml

Implementation Details

The installation script uses the GitHub API to:

  1. Parse GitHub URLs to extract owner, repo, branch, and path
  2. Fetch directory contents recursively
  3. Download all files while preserving directory structure
  4. Validate job names and provide user-friendly error messages

The skill guides users through:

  1. Obtaining the GitHub URL for a job
  2. Running the installation script
  3. Reviewing the job's README for customization requirements
  4. Applying project-specific customizations (placeholder replacement, configuration)
  5. Updating documentation
  6. Syncing to generate slash commands

This enables users to leverage a library of pre-built, reusable DeepWork jobs while maintaining flexibility for project-specific customization.

@nhorton nhorton force-pushed the claude/add-remote-job-installer-Qrgcu branch from f66b516 to 536385f Compare January 27, 2026 01:37
Add a new standalone skill to deepwork_jobs that allows users to install
jobs from remote GitHub repositories (like the DeepWork job library).

Changes:
- Add install_remote_job.sh script that fetches job files from GitHub URLs
- Add clone_remote_job.md step instructions for guiding customization
- Update job.yml to version 1.1.0 with the new skill
- Regenerate skills for all platforms
- Update architecture.md and CHANGELOG.md
- Remove redundant description text about installing jobs
- Simplify Step 6 to just review .claude/skills instead of verbose reload instructions
- Remove Available Commands section from output format
- Update Next Steps to include workflow kick-off instructions
@nhorton nhorton force-pushed the claude/add-remote-job-installer-Qrgcu branch from aaa42fa to d28a2f3 Compare January 28, 2026 15:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants