Agent skill

Clarify Question Loop

by agentlas-ai in agentlas-ai/Agentlas-OS

A skill your agent uses when a meta-agent request is too ambiguous to safely generate, package, publish, or adapt without one to five targeted questions.

Apache-2.0Auto-check passedWriting & Content

Install Clarify Question Loop

skills CLI
$ npx skills add agentlas-ai/Agentlas-OS --skill clarify-question-loop -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install agentlas-ai/Agentlas-OS clarify-question-loop --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/agentlas-ai/Agentlas-OS.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/clarify-question-loop .claude/skills/clarify-question-loop && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
clarify-question-loop
GitHub stars
1.6k
Token cost
~824 tokens
SKILL.md length
452 words
Files
1
Skills in repo
53
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when a meta-agent request is too ambiguous to safely generate, package, publish, or adapt without one to five targeted questions.

  • Works in 8 steps: Classify the current best mode. → If single-agent vs team selection would… → Follow up on role count, role-specific… → …
  • A meta-agent request is too ambiguous to safely generate
  • SKILL.md covers Procedure, Budgets and stop rule…, Default Questions and Plain-Language Question Rule, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Clarify Question Loop is an agent skill from agentlas-ai/Agentlas-OS. Use when a meta-agent request is too ambiguous to safely generate, package, publish, or adapt without one to five targeted questions.

Its SKILL.md is about 820 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Writing & Content. The repository describes itself as: Agent OS: keep specialist agents in a hub, spin up a temporary orchestrator per task. Local-first, works with any model. The licence is Apache-2.0.

When your agent uses it

  • A meta-agent request is too ambiguous to safely generate
  • Adapt without one to five targeted questions

Example prompts

  • “/clarify-question-loop”

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Classify the current best mode.
  2. If single-agent vs team selection would change the package shape and the
  3. Follow up on role count, role-specific tools/permissions, whether outputs
  4. Identify missing facts that would change files or safety.
  5. Ask one to five short questions, preferably three. If more than five
  6. Do not ask for secrets. Ask for secret names or setup boundaries instead.
  7. After answers arrive, re-run mode classification if needed.
  8. Generate or repair the package using the answers and list assumptions.

What it can do on your machine

Read from SKILL.md and the folder at commit cfdebf8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Clarify Question Loop loads about 824 tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 452 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~39
When it runs · the whole SKILL.md, loaded when a task matches
~824

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from agentlas-ai/Agentlas-OS at commit cfdebf8, republished under its Apache-2.0 licence (© agentlas-ai). 452 words, ~824 tokens.

Download SKILL.mdSave it as .claude/skills/clarify-question-loop/SKILL.md (or your agent's skills folder).
name
clarify-question-loop
description
Use when a meta-agent request is too ambiguous to safely generate, package, publish, or adapt without one to five targeted questions.

Clarify Question Loop

Ask only questions that change the generated package, runtime adapter, safety boundary, or public/private release decision.

For /hep-build creation or behavior-changing packaging, this is not a substitute for the Builder Interview and Research Gate in contracts/builder-interview-research-gate.md. Run that gate first: ask an 8-12 question first batch, research similar agent repositories or comparables and academic/professional theory, then use this clarify loop only for the remaining narrow ambiguities.

Procedure

  1. Classify the current best mode.
  2. If single-agent vs team selection would change the package shape and the independent ownership boundaries are unclear, ask before generation. The first batch must include this plain-language question: "이 일을 한 명의 전문가가 처음부터 끝까지 맡으면 되나요, 아니면 조사/분석/검토처럼 여러 전문가가 나눠 맡고 마지막에 합쳐야 하나요?"
  3. Follow up on role count, role-specific tools/permissions, whether outputs must be synthesized, and whether artifacts are sequential dependencies or independent parallel packets.
  4. Identify missing facts that would change files or safety.
  5. Ask one to five short questions, preferably three. If more than five functional-quality questions remain, return to the Builder Interview and Research Gate instead of pretending the package is ready.
  6. Do not ask for secrets. Ask for secret names or setup boundaries instead.
  7. After answers arrive, re-run mode classification if needed.
  8. Generate or repair the package using the answers and list assumptions.

Budgets and stop rule (briefing interview engine)

This loop shares the briefing interview engine's contract (agentlas_cloud/interview/): a question is only worth asking if the answer would change execution, not just its phrasing. Respect the surface budget (chat 3-5 in one batch, stormbreaker <= 8 across two batches, build 8-12 plus follow-ups). 'decide later' is always a valid answer — record it as deferred, never re-ask. When answers you auto-confirmed from code/memory reach three in a row, the next question must go to the human.

Show full SKILL.md (148 more words)Show less

Default Questions

  • Which runtime targets should be supported?
  • Is this local-only, private-team, public open-source, or marketplace output?
  • What tools, APIs, files, or services must it use?
  • What should count as success?
  • What must it never read, write, publish, or spend?
  • 이 일을 한 명의 전문가가 처음부터 끝까지 맡으면 되나요, 아니면 조사/분석/검토처럼 여러 전문가가 나눠 맡고 마지막에 합쳐야 하나요?

Plain-Language Question Rule

Never ask non-technical users to choose internal labels such as single-agent, team-builder, ownership boundary, memory/context, synthesis, or produces/consumes. Translate them before asking:

  • ownership boundary -> "누가 따로 맡아야 하는 일인지";
  • memory/context -> "각자 따로 기억해야 할 자료, 기준, 진행 상황";
  • tools/permissions -> "각자 써도 되는 계정, 파일, 웹사이트, 도구";
  • synthesis -> "마지막에 결과를 한데 모으는 일";
  • sequential dependency -> "앞 사람이 끝낸 결과를 다음 사람이 이어받는 순서".

If a question still sounds technical, split it into two shorter everyday questions and give examples such as 조사, 분석, 검토, 승인.

Reference

See docs/clarify-question-loop.md.

© agentlas-ai, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/clarify-question-loop of agentlas-ai/Agentlas-OS.

Open the folder on GitHubat commit cfdebf8

Compare with similar skills

Clarify Question Loop next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Clarify Question Loop compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Clarify Question Loop this skillagentlas-ai/Agentlas-OS1.6k—~824Automated safety check: PassApache-2.0
Socialcoreyhaines31/marketingskills54k4 repos~4.5kAutomated safety check: PassMIT
HumanizerAzure-Samples/interview-coach-agent-framework17237 repos~5.8kAutomated safety check: PassMIT
Avoid AI Writingconorbronsdon/avoid-ai-writing4.9k3 repos~8.1kAutomated safety check: PassMIT
JavaScript Concept Fact Checkerleonardomso/33-js-concepts67k1 repos~5kAutomated safety check: PassMIT
User-Facing Text Cleanupguillaumemeyer/watermarks-remover24k—~3.5kAutomated safety check: PassMIT

Similar skills

  • Social

    coreyhaines31/marketingskills

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, or Facebook, or wants to do social listening and engagement triage.

    54k GitHub starsUsed in 4 repos~4.5k tokens
    Writing & ContentAuto-check passed
  • Humanizer

    Azure-Samples/interview-coach-agent-framework

    Official

    Remove signs of AI-generated writing from text. An agent skill from Azure-Samples/interview-coach-agent-framework.

    172 GitHub starsUsed in 37 repos~5.8k tokens
    Writing & ContentAuto-check passed
  • Avoid AI Writing

    conorbronsdon/avoid-ai-writing

    Audit and rewrite content to remove AI writing patterns ("AI-isms").

    4.9k GitHub starsUsed in 3 repos~8.1k tokens
    Writing & ContentAuto-check passed
  • JavaScript Concept Fact Checker

    leonardomso/33-js-concepts

    Verifies the technical accuracy of JavaScript concept pages by checking code examples, MDN and ECMAScript claims and external links through a five-phase method.

    67k GitHub starsUsed in 1 repo~5k tokens
    Writing & ContentAuto-check passed
  • User-Facing Text Cleanup

    guillaumemeyer/watermarks-remover

    Audits prose for invisible Unicode characters and rewrites it while keeping facts, citations, code and required disclosures unchanged and the writer's voice intact.

    24k GitHub stars~3.5k tokensUpdated 2 days ago
    Writing & ContentAuto-check passed
  • Social Content

    freekmurze/dotfiles

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms.

    1k GitHub starsUsed in 23 repos~2.1k tokens
    Writing & ContentAuto-check passed

More from agentlas-ai/Agentlas-OS

All 53 skills in this repo
  • Agentlas Security Scan

    agentlas-ai/Agentlas-OS

    A skill your agent uses when an agent folder must pass the Agentlas Cloud 2-stage security scan (static rules + BYOK LLM judgment) before private sync or public publish, or when asked to…

    1.6k GitHub starsUsed in 1 repo~822 tokens
    Auto-check passed
  • Hephaestus Build

    agentlas-ai/Agentlas-OS

    A skill your agent uses when the user types /prompts:hep-build or /agentlas-build, mentions @Hephaestus for build work, asks to create a single Agentlas agent, create a multi-agent team, or package…

    1.6k GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed
  • Hephaestus Graph

    agentlas-ai/Agentlas-OS

    A skill your agent uses when the user types /hep-graph or asks to create, list, inspect, or request a run of an Agentlas automation graph.

    1.6k GitHub stars~498 tokensUpdated yesterday
    Auto-check passed
  • Hephaestus Upload

    agentlas-ai/Agentlas-OS

    A skill your agent uses when the user types $hephaestus-upload, /hep-upload, or /agentlas-upload, or asks to upload, publish, or list an Agentlas agent or team.

    1.6k GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Routing Card Authoring

    agentlas-ai/Agentlas-OS

    A skill your agent uses whenever a build emits or repairs .agentlas/routing-card.json — the shared card contract for the single-agent builder, the team builder, and the packager.

    1.6k GitHub stars~2.7k tokensUpdated yesterday
    Auto-check passed
  • Team Builder Packaging

    agentlas-ai/Agentlas-OS

    A skill your agent uses when generating or auditing a multi-role agent team package with orchestrator, PM Soul, Memory Curator, Policy Gate, workers, eval, QA, handoffs, and runtime adapters.

    1.6k GitHub stars~642 tokensUpdated yesterday
    Auto-check passed

Questions about Clarify Question Loop

What does Clarify Question Loop do?

A skill your agent uses when a meta-agent request is too ambiguous to safely generate, package, publish, or adapt without one to five targeted questions. Clarify Question Loop is an agent skill from agentlas-ai/Agentlas-OS. Use when a meta-agent request is too ambiguous to safely generate, package, publish, or adapt without one to five targeted questions.

When should I use Clarify Question Loop?

Clarify Question Loop fits situations like: A meta-agent request is too ambiguous to safely generate; adapt without one to five targeted questions.

How do I install Clarify Question Loop in Claude Code?

Run `npx skills add agentlas-ai/Agentlas-OS --skill clarify-question-loop -a claude-code`. Or copy the skill folder (skills/clarify-question-loop in agentlas-ai/Agentlas-OS) into .claude/skills/clarify-question-loop in your project. Claude Code loads it when a task matches its description.

How do I install Clarify Question Loop in Codex?

Run `npx skills add agentlas-ai/Agentlas-OS --skill clarify-question-loop -a codex`. Or copy the skill folder (skills/clarify-question-loop in agentlas-ai/Agentlas-OS) into .agents/skills/clarify-question-loop in your project. Codex loads it when a task matches its description.

Can I use Clarify Question Loop in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add agentlas-ai/Agentlas-OS --skill clarify-question-loop -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/clarify-question-loop, .gemini/skills/clarify-question-loop, .github/skills/clarify-question-loop and .opencode/skills/clarify-question-loop in your project.

What does Clarify Question Loop need to run?

SKILL.md names no scripts, command-line tools or credentials: Clarify Question Loop is instructions for the agent only.

Does Clarify Question Loop access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Clarify Question Loop safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Clarify Question Loop use?

Clarify Question Loop is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Clarify Question Loop use?

About 824 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Clarify Question Loop?

Skills that share tags, products or a category with Clarify Question Loop: Social (coreyhaines31/marketingskills, 54k stars), Humanizer (Azure-Samples/interview-coach-agent-framework, 172 stars), Avoid AI Writing (conorbronsdon/avoid-ai-writing, 4.9k stars) and JavaScript Concept Fact Checker (leonardomso/33-js-concepts, 67k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Clarify Question Loop?

agentlas-ai (a GitHub organization) maintains it in agentlas-ai/Agentlas-OS, which has 1,575 GitHub stars. The repository holds 53 skills in this directory. The repository was last updated on October 6, 2026.

Source: agentlas-ai/Agentlas-OS on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.