ask-questions-if-underspecified SKILL.md skillA

ask-questions-if-underspecified from ghosteken/agent-harness is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add ghosteken/agent-harness/ask-questions-if-underspecified@git:20260721.efafd9c

Pins git:20260721.efafd9c in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
ghosteken/agent-harness
Path
archive/skills-community/ask-questions-if-underspecified/SKILL.md
Versions recorded
1
Latest version
git:20260721.efafd9c, committed Jul 21, 2026
Size
4,337 bytes
Repository stars
4
License
MIT

Clarify requirements before implementing. Use when serious doubts arise.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Ask Questions If Underspecified

## When to Use
Use this skill when a request has multiple plausible interpretations or key details (objective, scope, constraints, environment, or safety) are unclear.

## When NOT to Use

Do not use this skill when the request is already clear, or when a quick, low-risk discovery read can answer the missing details.

## Goal

Ask the minimum set of clarifying questions needed to avoid wrong work; do not start implementing until the must-have questions are answered (or the user explicitly approves proceeding with stated assumptions).

## Workflow

### 1) Decide whether the request is underspecified

Treat a request as underspecified if after exploring how to perform the work, some or all of the following are not clear:
- Define the objective (what should change vs stay the same)
- Define "done" (acceptance criteria, examples, edge cases)
- Define scope (which files/components/users are in/out)
- Define constraints (compatibility, performance, style, deps, time)
- Identify environment (language/runtime versions, OS, build/test runner)
- Clarify safety/reversibility (data migration, rollout/rollback, risk)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ghosteken/agent-harness/ask-questions-if-underspecified@sha256:42690ce0d2adcb23

The line at the top of this page pins the label git:20260721.efafd9c, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ztvv722qp5kohu4r.svg)](https://markdownregistry.com/a/art_ztvv722qp5kohu4r)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Jul 21, 2026.

versioncommittedcommitsizeaudit
git:20260721.efafd9c latest2026-07-21 efafd9c 4,337 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4337 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

ghosteken/agent-harness · 4 stars · license MIT · pushed 2026-10-13 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ztvv722qp5kohu4r
GET https://markdownregistry.com/api/v1/resolve?ref=ghosteken/agent-harness/ask-questions-if-underspecified
GET https://markdownregistry.com/api/v1/blob/42690ce0d2adcb2377503246d15469ccaed60f6a32ce404016432f012050f737

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from ghosteken/agent-harness

AGENTS.md AGENTS.md file
ghosteken/agent-harness · AGENTS.md
git:20261008.1dbcd11 · audit A · 4 stars
CLAUDE.md CLAUDE.md file
ghosteken/agent-harness · CLAUDE.md
git:20261008.1dbcd11 · audit A · 4 stars
2slides-ppt-generator SKILL.md skill
ghosteken/agent-harness · archive/skills-community/2slides-ppt-generator/SKILL.md · AI-powered presentation generation via the 2slides API — create slides from text, match a reference image style…
git:20260721.efafd9c · audit A · 4 stars
3d-web-experience SKILL.md skill
ghosteken/agent-harness · archive/skills-community/3d-web-experience/SKILL.md · Expert in building 3D experiences for the web - Three.js, React
git:20260721.efafd9c · audit A · 4 stars
ab-test-setup SKILL.md skill
ghosteken/agent-harness · archive/skills-community/ab-test-setup/SKILL.md · Structured guide for setting up A/B tests with mandatory gates for hypothesis, metrics, and execution readiness.
git:20260721.efafd9c · audit A · 4 stars
acceptance-orchestrator SKILL.md skill
ghosteken/agent-harness · archive/skills-community/acceptance-orchestrator/SKILL.md · Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and…
git:20260721.efafd9c · audit A · 4 stars
accesslint-audit SKILL.md skill
ghosteken/agent-harness · archive/skills-community/accesslint-audit/SKILL.md · Find and fix WCAG 2.2 accessibility issues. Two modes — report (sweep a codebase or page, produce a prioritized written…
git:20260721.efafd9c · audit A · 4 stars
accesslint-diff SKILL.md skill
ghosteken/agent-harness · archive/skills-community/accesslint-diff/SKILL.md · Diff a live page's accessibility violations against a baseline — by default compares uncommitted changes (stash-based)…
git:20260721.efafd9c · audit A · 4 stars
accesslint-scan SKILL.md skill
ghosteken/agent-harness · archive/skills-community/accesslint-scan/SKILL.md · Audit a live page for accessibility issues, locate each WCAG violation precisely, and return a selector-grounded fix…
git:20260721.efafd9c · audit A · 4 stars
accint-solve SKILL.md skill
ghosteken/agent-harness · archive/skills-community/accint-solve/SKILL.md · Route agent work through AccInt's MCP memory loop: retrieve prior outcomes, resolve frames, and close commitments with…
git:20260721.efafd9c · audit A · 4 stars
active-directory-attacks SKILL.md skill
ghosteken/agent-harness · archive/skills-community/active-directory-attacks/SKILL.md · Provide comprehensive techniques for attacking Microsoft Active Directory environments. Covers reconnaissance…
git:20260721.efafd9c · audit A · 4 stars
activecampaign-automation SKILL.md skill
ghosteken/agent-harness · archive/skills-community/activecampaign-automation/SKILL.md · Automate ActiveCampaign tasks via Rube MCP (Composio): manage contacts, tags, list subscriptions, automation…
git:20260721.efafd9c · audit A · 4 stars

Every file in ghosteken/agent-harness

Other files named ask-questions-if-underspecified

ask-questions-if-underspecified SKILL.md skill
sickn33/agentic-awesome-skills · plugins/agentic-awesome-skills-claude/skills/ask-questions-if-underspecified/SKILL.md · Clarify requirements before implementing. Use when serious doubts arise.
git:20260905.472169c · audit A · 48,329 stars
ask-questions-if-underspecified SKILL.md skill
dicklesworthstone/pi_agent_rust · tests/ext_conformance/artifacts/agents-mikeastock/skills/ask-questions-if-underspecified/SKILL.md · Clarify requirements before implementing. Do not use automatically, only when invoked explicitly.
git:20260205.788be98 · audit A · 1,915 stars

Browse by kind, by grade A, or by owner.