specifier-job

Converts task descriptions into human-approved Gherkin acceptance specs before implementation.

Updated Jul 27, 2026
One-click install
npx skills add https://github.com/arayaroma/ether --skill specifier-job-arayaroma
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: specifier-job
Source: https://github.com/arayaroma/ether/tree/main/skills/specifier-job
Command: npx skills add https://github.com/arayaroma/ether --skill specifier-job-arayaroma

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Autonomous coding agents often implement features straight from a one-line task description, producing code that misses the real intent. This Skill inserts a specification gate: it turns each pending task into a concrete Gherkin acceptance spec, requires explicit human approval, and only then hands the approved spec to the implementation job. ## Core Features & Use Cases - Job draining: Pulls pending specifier jobs from the ether-pro job store and processes each one against its target repository. - Spec drafting: Reads the target repo's own conventions (CLAUDE.md, AGENTS.md, existing spec directories) and writes a Gherkin .feature file covering golden-path and edge-case scenarios. - Mandatory approval gate: Never hands off a spec without explicit human approval, regardless of the autonomy tier, preventing wasted downstream implementation runs. - Automatic handoff: On approval, enqueues a pr-author job referencing the approved spec and records the run outcome for the autonomy state machine. - Use Case: You queue a job with the task "add password reset via email". The Skill drafts Given/When/Then scenarios for the reset flow, you review and approve them, and a pr-author-job is automatically created to implement exactly that spec. ## Quick Start Run the specifier job to drain pending specifier jobs and turn each task into an approved Gherkin spec before any code is written.

Frequently Asked Questions about specifier-job

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

FAQPage Schema
How do I turn a task description into an acceptance spec before coding?▼

Add a specifier job with `ether job add --type specifier --target <repo> --params '{"task":"<description>"}'`, then run this Skill. It drafts a Gherkin .feature file with Given/When/Then scenarios, waits for your approval, and hands the spec to a pr-author job.

How do I schedule the specifier job to run automatically?▼

Use `/loop <interval> /specifier-job` in a live session. Unattended CronCreate scheduling is discouraged because the mandatory human approval gate in step 4 requires someone to be present to approve each drafted spec.

Does the specifier job implement the code after writing the spec?▼

No, it only produces an approved spec and never implements. On approval it automatically enqueues a pr-author job with the spec path, and that separate job handles implementation with its own scoping and TDD steps.

Can the approval gate be skipped at higher autonomy tiers?▼

No. Unlike other jobs whose write actions can auto-promote to skip confirmation, the specifier approval gate always requires explicit human approval regardless of tier, because a wrong spec silently accepted wastes an entire downstream implementation run.

Why must ether job commands run from ether-pro's directory and not the target repo?▼

Running `ether job` subcommands from inside the target repo is a hard rule violation shared with other job skills. All job management commands must run from ether-pro's own directory, while only the spec file itself is written into the target repo.