deepwork_jobs.review_job_spec

Validate DeepWork job.yml files against doc-spec quality criteria.

49|3|Updated Jan 11, 2026
One-click install
npx skills add https://github.com/Unsupervisedcom/deepwork --skill deepwork-jobs-review-job-spec-unsupervisedcom
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deepwork_jobs.review_job_spec
Source: https://github.com/Unsupervisedcom/deepwork/tree/main/.claude/skills/deepwork_jobs.review_job_spec
Command: npx skills add https://github.com/Unsupervisedcom/deepwork --skill deepwork-jobs-review-job-spec-unsupervisedcom

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates unbiased validation of a DeepWork job.yml against the doc-spec quality criteria using a sub-agent.

Core Features & Use Cases

  • Automated quality review: Spawns a Haiku sub-agent to audit all doc-spec quality criteria.
  • Guided fixes: Provides actionable suggestions to bring job.yml into specification compliance.
  • Re-review loop: Supports iterative corrections until all criteria pass.
  • Use cases: after /deepwork_jobs.define, run this skill to validate the job.yml, before /deepwork_jobs.implement.

Quick Start

Run this skill after define to validate .deepwork/jobs/[job_name]/job.yml, review the sub-agent feedback, and apply fixes before implementing.

Frequently Asked Questions about deepwork_jobs.review_job_spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate a job.yml file against quality criteria?

To validate a job.yml file, this skill spawns a Haiku sub-agent to audit it against all doc-spec quality criteria. It evaluates the file to ensure your specification is solid before implementation begins.

What is the best way to check a DeepWork job spec before implementation?

The best way to check a DeepWork job spec is using an automated sub-agent review against the doc_spec quality criteria. It references the .deepwork/doc_specs/job_spec.md file to verify all nine specification criteria pass.

When do I need to run job spec validation in my workflow?

You need to run job spec validation after the define step and before implementation. This ensures your job.yml is solid, preventing specification errors from propagating into the actual implementation phase.

Does the validation process support iterative fixes for a failing job.yml?

Yes, the validation process supports iterative fixes through a re-review loop. It provides actionable suggestions to bring your job.yml into specification compliance and continues re-reviewing until all criteria pass.

Can I use a sub-agent to objectively review my YAML job specifications?

Yes, you can use a sub-agent to provide unbiased validation of your YAML job specifications. This automated quality review prevents human oversight by systematically auditing all defined doc-spec criteria.