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.