ask-questions-if-underspecified SKILL.md skillA

This file is byte-identical to the first copy the registry indexed. Same content hash, so the same checks give both the same grade.

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

Install it, pinned
mdr add francostino/opencode-skills-collection/ask-questions-if-underspecified@git:20261104.a17e8c9

Pins git:20261104.a17e8c9 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
francostino/opencode-skills-collection
Path
bundled-skills/ask-questions-if-underspecified/SKILL.md
Versions recorded
4
Latest version
git:20261104.a17e8c9, committed Nov 4, 2026
First version recorded
Jul 30, 2026
Size
4,359 bytes
Repository stars
90
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 francostino/opencode-skills-collection/ask-questions-if-underspecified@sha256:d13ef519ce7b5088

The line at the top of this page pins the label git:20261104.a17e8c9, 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_aenjnbgyp3tm7xrt.svg)](https://markdownregistry.com/a/art_aenjnbgyp3tm7xrt)

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

Versions

The registry has recorded 4 versions of this file, between Jul 30, 2026 and Nov 4, 2026, about one every 32 days.

versioncommittedcommitsizeaudit
git:20261104.a17e8c9 latest2026-11-04 a17e8c9 4,359 BA view · diff
git:20261022.d57eeb62026-10-22 d57eeb6 4,587 BA view · diff
git:20261015.fac8b7e2026-10-15 fac8b7e 4,587 BA view · diff
git:20260730.90257ed2026-07-30 90257ed 4,334 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 (4359 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

francostino/opencode-skills-collection · 90 stars · license MIT · pushed 2026-11-08 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_aenjnbgyp3tm7xrt
GET https://markdownregistry.com/api/v1/resolve?ref=francostino/opencode-skills-collection/ask-questions-if-underspecified
GET https://markdownregistry.com/api/v1/blob/d13ef519ce7b5088a8b4202fa41c84cfc35b4904028839863b71a527886d6e9b

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 francostino/opencode-skills-collection

AGENTS.md AGENTS.md file
francostino/opencode-skills-collection · AGENTS.md
git:20260820.c2f6bd5 · audit A · 90 stars
00-andruia-consultant SKILL.md skill
francostino/opencode-skills-collection · bundled-skills/00-andruia-consultant/SKILL.md · Usar al iniciar o mejorar un proyecto de IA: diagnostica código y restricciones, propone skills existentes y redacta…
git:20261015.fac8b7e · audit A · 90 stars
007 SKILL.md skill
francostino/opencode-skills-collection · bundled-skills/007/SKILL.md · Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response…
git:20260906.7d37dc9 · audit A · 90 stars
10-andruia-skill-smith SKILL.md skill
francostino/opencode-skills-collection · bundled-skills/10-andruia-skill-smith/SKILL.md · Usar para crear o mejorar una skill de Andru.ia: define entradas y resultados, redacta SKILL.md con ejemplos y límites…
git:20261015.fac8b7e · audit A · 90 stars
20-andruia-niche-intelligence SKILL.md skill
francostino/opencode-skills-collection · bundled-skills/20-andruia-niche-intelligence/SKILL.md · Usar tras definir el sector de un proyecto: prepara un dossier en español con contexto, normas aplicables, patrones UX…
git:20261015.fac8b7e · audit A · 90 stars
2slides-ppt-generator SKILL.md skill
francostino/opencode-skills-collection · bundled-skills/2slides-ppt-generator/SKILL.md · AI-powered presentation generation via the 2slides API — create slides from text, match a reference image style…
git:20260906.7d37dc9 · audit A · 90 stars
360-feedback-system SKILL.md skill
francostino/opencode-skills-collection · bundled-skills/360-feedback-system/SKILL.md · 360 feedback register: reviewer, subject, review cycle, visibility, due date and score, as CSV, SQL, JSON Schema or…
git:20261015.fac8b7e · audit A · 90 stars
3d-web-experience SKILL.md skill
francostino/opencode-skills-collection · bundled-skills/3d-web-experience/SKILL.md · Use when building or debugging web 3D scenes, product configurators or portfolios with Three.js, React Three Fiber or…
git:20261015.fac8b7e · audit A · 90 stars
aas-compose-stack SKILL.md skill
francostino/opencode-skills-collection · bundled-skills/aas-compose-stack/SKILL.md · Preserve the coding agent's explicit AAS skill selection as a validated stack and optional evidence.
git:20261004.4720433 · audit A · 90 stars
aas-discover SKILL.md skill
francostino/opencode-skills-collection · bundled-skills/aas-discover/SKILL.md · Discover AAS skills for an explicit task and compare their complete instructions without installing them.
git:20261004.4720433 · audit A · 90 stars
aas-review-stack SKILL.md skill
francostino/opencode-skills-collection · bundled-skills/aas-review-stack/SKILL.md · Review AAS stack manifests, preview plans and selection evidence in Workbench without applying changes.
git:20261004.4720433 · audit A · 90 stars
ab-test-setup SKILL.md skill
francostino/opencode-skills-collection · bundled-skills/ab-test-setup/SKILL.md · Use when designing an A/B or split test: define the hypothesis, control and variants, estimate sample size, verify…
git:20260906.7d37dc9 · audit A · 90 stars

Every file in francostino/opencode-skills-collection

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 · 49,308 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,966 stars
ask-questions-if-underspecified SKILL.md skill
ghosteken/agent-harness · archive/skills-community/ask-questions-if-underspecified/SKILL.md · Clarify requirements before implementing. Use when serious doubts arise.
git:20260721.efafd9c · audit A · 4 stars

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