Coding & Refactoringlow risk

spec

Create or update a minimal SPEC.md through a short interview, then use it as the source of truth for complex features, refactors, or ambiguous requests. Use when the user asks for /spec, spec-driven development, or when SPEC.md is missing or stale before substantial work.

yourconscience/dotagents·skills/spec/SKILL.md
34/ 100Recommendation
↓

Install this skill

Choose your coding agent and copy a project or personal installation command.

Pinned to the indexed commit
Project installation.agents/skills/spec
npx skills add https://github.com/yourconscience/dotagents/tree/80e2db690cd0d03fb1fb7eac59bf5de6be387497/skills/spec -a codex -y
Personal installation~/.agents/skills/spec
npx skills add https://github.com/yourconscience/dotagents/tree/80e2db690cd0d03fb1fb7eac59bf5de6be387497/skills/spec -a codex -g -y
Manual folder.agents/skills/specOfficial docs ↗
Project installation.claude/skills/spec
npx skills add https://github.com/yourconscience/dotagents/tree/80e2db690cd0d03fb1fb7eac59bf5de6be387497/skills/spec -a claude-code -y
Personal installation~/.claude/skills/spec
npx skills add https://github.com/yourconscience/dotagents/tree/80e2db690cd0d03fb1fb7eac59bf5de6be387497/skills/spec -a claude-code -g -y
Manual folder.claude/skills/specOfficial docs ↗
Project installation.agents/skills/spec
npx skills add https://github.com/yourconscience/dotagents/tree/80e2db690cd0d03fb1fb7eac59bf5de6be387497/skills/spec -a github-copilot -y
Personal installation~/.copilot/skills/spec
npx skills add https://github.com/yourconscience/dotagents/tree/80e2db690cd0d03fb1fb7eac59bf5de6be387497/skills/spec -a github-copilot -g -y
Manual folder.agents/skills/specOfficial docs ↗
Project installation.agents/skills/spec
npx skills add https://github.com/yourconscience/dotagents/tree/80e2db690cd0d03fb1fb7eac59bf5de6be387497/skills/spec -a cursor -y
Personal installation~/.cursor/skills/spec
npx skills add https://github.com/yourconscience/dotagents/tree/80e2db690cd0d03fb1fb7eac59bf5de6be387497/skills/spec -a cursor -g -y
Manual folder.agents/skills/specOfficial docs ↗
Project installation.agents/skills/spec
npx skills add https://github.com/yourconscience/dotagents/tree/80e2db690cd0d03fb1fb7eac59bf5de6be387497/skills/spec -a gemini-cli -y
Personal installation~/.gemini/skills/spec
npx skills add https://github.com/yourconscience/dotagents/tree/80e2db690cd0d03fb1fb7eac59bf5de6be387497/skills/spec -a gemini-cli -g -y
Native Gemini CLIgemini skills install https://github.com/yourconscience/dotagents.git --scope workspace --path skills/spec
Manual folder.agents/skills/specOfficial docs ↗
⚠ Installation uses the open-source skills CLI. Inspect the source and permissions before running the command.

Skill instructions

View source on GitHub ↗
# Spec

## Overview

Run a short interview and produce or update a minimal `SPEC.md` that guides planning and implementation without bloating docs.

## Workflow

1) Decide if a spec is needed.
   - Use this flow for new features, refactors, or ambiguous work.
   - Also use it when `SPEC.md` is missing or stale, or the user asks for `/spec`.

2) Interview (5 questions max).
   - When the harness exposes a structured question tool, use it. Claude Code: `AskUserQuestion`. Codex or Codex-derived harnesses: `request_user_input` when available. Hermes: `clarify`.
   - Otherwise ask plain text directly.
   - Skip questions already answered in the request or prior context.
   - Aim for concise, unambiguous answers.

Suggested questions:
1. What is the primary goal and user-visible behavior?
2. What is explicitly out of scope?
3. What are the acceptance tests or success criteria?
4. What constraints matter (stack, performance, data, integrations, policies)?
5. What code areas or existing patterns should be reused?

3) Draft `SPEC.md` at the project root (or update it if present).
   - Keep it short. One page if possible.
   - Use the template below and keep sections with content only.

4) Confirm with the user before planning or coding.

5) After implementation, append a short "Outcome / Deviations" section with what changed from the spec.

## Minimal SPEC.md template

```markdown
# SPEC

## Goal

## Non-goals

## User story / behavior

## Acceptance tests

## Constraints

## Dependencies / integrations

## Risks / open questions

## Codebase notes

## Outcome / Deviations
```