The research-domain clarification skill — find underspecified items in a thesis spec.md (prose wrongif, universe rows without rationale, missing budget/expiry/pins, ambiguous pillars), ask the human…

Apache-2.0Auto-check passedEducation

Install Clarify

skills CLI
$ npx skills add agentii-ai/agentii-investment-intelligence --skill clarify -a claude-code

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

GitHub CLI
$ gh skill install agentii-ai/agentii-investment-intelligence clarify --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/agentii-ai/agentii-investment-intelligence.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/vertical-plugins/scenarios/skills/agentii/clarify .claude/skills/clarify && 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
GitHub stars
207
Used in
1 other repo
Token cost
~839 tokens
SKILL.md length
265 words
Files
2 (incl. references)
Skills in repo
79
Repo updated
First seen
Licence
Apache-2.0

At a glance

The research-domain clarification skill — find underspecified items in a thesis spec.md (prose wrongif, universe rows without rationale, missing budget/expiry/pins, ambiguous pillars), ask the human…

  • Works in 2 steps: Analyze (deterministic) → Encode (after the human answers)
  • Tasks that involve Essays and academic help
  • SKILL.md covers Invocation, Two phases and Rules
  • Calls python3

What it does

Clarify is an agent skill from agentii-ai/agentii-investment-intelligence. The research-domain clarification skill — find underspecified items in a thesis spec.md (prose wrongif, universe rows without rationale, missing budget/expiry/pins, ambiguous pillars), ask the human structured questions WITH options (max 5 per round), encode the answers back into spec.md's Clarifications section, and re-evaluate checklists/thesis-quality.md after every write (Q32 bidirectional maintenance).

Its SKILL.md is about 840 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/modes.md`).

It sits in Education, covering Essays and academic help. The repository describes itself as: Claude-type skills for institutional equity research — 25 AI agent skills with SEC filings, XBRL financials, earnings calendars, DCF/comps/LBO models, and PPT generation. Powered… The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Essays and academic help

Example prompts

  • “/clarify”

Requirements

  • Python 3

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Analyze (deterministic)
  2. Encode (after the human answers)

What it can do on your machine

Read from SKILL.md and the folder at commit 86980e1. 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

    Shell commands in SKILL.md call:

    • python3

    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 loads about 839 tokens when it runs, and up to ~994 if it reads all its reference files. Until then it costs about 105 tokens; SKILL.md has 265 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~105
When it runs · the whole SKILL.md, loaded when a task matches
~839
With references · SKILL.md plus every file in references/, read only if the agent opens them
~994

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 agentii-ai/agentii-investment-intelligence at commit 86980e1, republished under its Apache-2.0 licence (© agentii-ai). 265 words, ~839 tokens.

Download SKILL.mdSave it as .claude/skills/clarify/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
clarify
description
The research-domain clarification skill — find underspecified items in a thesis spec.md (prose wrong_if, universe rows without rationale, missing budget/expiry/pins, ambiguous pillars), ask the human structured questions WITH options (max 5 per round), encode the answers back into spec.md's Clarifications section, and re-evaluate checklists/thesis-quality.md after every write (Q32 bidirectional maintenance).
role
kit
market_data_stage
none

agentii.clarify

The 8th kit command — closes the gap Q32 itself assumed: upstream speckit-clarify re-evaluates the quality checklist after every spec write, but spec 046 never named the command that performs the clarification.

Invocation

Both phases run kit Python. Resolve the kit root once per shell first — contracts/kit-root.md. The kit's scripts do NOT ship with the skills, and this skill's old path (kit-scripts/, below) did not exist at all: it named a directory that has never been in this repository, so every documented invocation of clarify failed with "No such file or directory".

bash
# Resolve the kit root — contracts/kit-root.md. Never assume the CWD is the checkout.
KIT=""
for c in "${AGENTII_KIT_ROOT:-}" \
         "$(cat "$HOME/.claude/skills/agentii/.kit-root" 2>/dev/null)" \
         "${CLAUDE_PLUGIN_ROOT:-}"; do
  [ -n "$c" ] && [ -f "$c/scripts/agentii_cmd.py" ] && { KIT="$c"; break; }
done
if [ -z "$KIT" ]; then d="$PWD"; while [ "$d" != "/" ]; do
  [ -f "$d/scripts/agentii_cmd.py" ] && { KIT="$d"; break; }; d="$(dirname "$d")"; done; fi
[ -n "$KIT" ] || { echo "agentii kit not found — see contracts/kit-root.md" >&2; exit 1; }

Two phases

1. Analyze (deterministic)
bash
python3 "$KIT/scripts/agentii_cmd.py" clarify --thesis theses/001-… --questions

Emits a JSON list of candidate questions, each with:

  • id (stable — content-derived from the target)
  • target (pillar id / field / universe row)
  • question (exact, in the spec's working language)
  • options (derived where possible; null = free-form)

Candidates come from a deterministic scanner (never vibes): prose wrong_if (missing metric=/threshold=/source=), universe rows without rationale, missing budget, missing expiry_triggers, subscription tokens not in TICKER × skill form, missing as_of/pins, pillars without priority.

2. Encode (after the human answers)
bash
# $KIT comes from `## Invocation` above — re-run that resolver if this is a new shell.
python3 "$KIT/scripts/agentii_cmd.py" clarify --thesis theses/001-… --answers '<json>'
  • Appends each answer to spec.md's ## Clarifications section (- [YYYY-MM-DD] Q: … → A: …).
  • Re-evaluates checklists/thesis-quality.md after the write (Q32: the machine-maintained checklist is bidirectional — report "N/M items passing" plus regressions).

Rules

  • Max 5 questions per round (upstream v1.0.4's tightened limit; spec recorded it as the convention to follow).
  • Only ask what blocks the next step — every question must name the field it unblocks.
  • Answers are encoded verbatim (professional English); a Chinese question is translated to English before encoding (the project's first language is English).
  • Never ask about facts obtainable from the platform (that's the skills' job); clarify intent only.

© agentii-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

SKILL.md and 1 other file (references) in plugins/vertical-plugins/scenarios/skills/agentii/clarify of agentii-ai/agentii-investment-intelligence.

  • SKILL.md
  • references/modes.md

Open the folder on GitHubat commit 86980e1

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in agentii-ai/agentii-investment-intelligence, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Clarify 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Clarify this skillagentii-ai/agentii-investment-intelligence2071 repos~839Automated safety check: PassApache-2.0
Academic Paper StrategistAAASS554/codex-academic-paper-skills5391 repos~2.7kAutomated safety check: PassMIT
Modeling Paper Rubric and Model Selectoryushui2022/MathModel-Skill4521 repos~1.8kAutomated safety check: PassMIT
Humanities Thesisganzhi-black/humanities-thesis-skill630—~1.7kAutomated safety check: PassMIT
Skill Thesis Writeryanlin-cheng/skill-thesis-writer207—~1.6kAutomated safety check: PassCustom licence
Thesis CreatorStars-OC/thesis-creator228—~2.8kAutomated safety check: PassMIT

Similar skills

  • Academic Paper Strategist

    AAASS554/codex-academic-paper-skills

    A skill your agent uses when the user needs to plan, de-risk, or ground a software engineering / computer science undergraduate thesis from a real codebase before final writing.

    539 GitHub starsUsed in 1 repo~2.7k tokens
    EducationAuto-check passed
  • Builds a scoring-aligned outline for a mathematical modeling paper and a model selection plan with baseline, improvement and validation experiments.

    452 GitHub starsUsed in 1 repo~1.8k tokens
    EducationAuto-check passed
  • Humanities Thesis

    ganzhi-black/humanities-thesis-skill

    人文社科论文写作全流程指导。适用于文学、历史、哲学、社会学、传播学、新闻学、文化研究等领域的中文学术论文。当用户提到"论文""写论文""选题""文献综述""论文修改""论文结构""摘要翻译""帮我查文献""参考文献格式""论文没有新意""理论和文本脱节""章节之间缺乏逻辑""帮我检查论文""摘要翻译成英文""投稿准备""脚注格式"等场景时触发。覆盖从选题到投稿的全流程,包含防幻觉规则、学术数据库…

    630 GitHub stars~1.7k tokensUpdated 5 mo ago
    EducationAuto-check passed
  • Skill Thesis Writer

    yanlin-cheng/skill-thesis-writer

    跨学科AI论文写作助手,专为本科生/研究生论文写作提供全方位支持。当用户需要撰写论文内容、设计论文框架结构、优化学术语体风格、处理参考文献格式(GB/T 7714-2015)、生成统计分析表格、或降低AI生成文本痕迹时使用此技能。支持工科(计算机/电子/机械等)、心理学、教育学、管理学等多学科领域,符合中国学术论文写作规范。

    207 GitHub stars~1.6k tokensUpdated 5 mo ago
    EducationAuto-check passed
  • Thesis Creator

    Stars-OC/thesis-creator

    Walks Chinese undergraduates through writing a graduation thesis from topic to Word export, with text-similarity reduction and AI-text rate rewriting and checks.

    228 GitHub stars~2.8k tokensUpdated 4 mo ago
    EducationAuto-check passed
  • Aigc Detector

    free-revalution/AIGC-Detector-Pro

    Academic paper AI content detection, rewriting, and thesis writing assistant.

    141 GitHub stars~2.8k tokensUpdated 4 mo ago
    EducationAuto-check passed

More from agentii-ai/agentii-investment-intelligence

All 79 skills in this repo
  • Constitution

    agentii-ai/agentii-investment-intelligence

    Scaffold and amend the L1 Investment Constitution — [ALLCAPS] placeholder bootstrap, SemVer bump rules, Sync Impact Report, MINOR/MAJOR re-examination dispatch after the gate-5 budget confirm.

    207 GitHub starsUsed in 1 repo~596 tokens
    Auto-check passed
  • Implement

    agentii-ai/agentii-investment-intelligence

    Execute research tasks — checklist soft gate, phase dispatch with explicit thesisdir, budget enforcement (halt + approval card on overrun), skillpin recording (versionhash content-hashed per skill…

    207 GitHub starsUsed in 1 repo~583 tokens
    Auto-check passed
  • Tasks

    agentii-ai/agentii-investment-intelligence

    Decompose the plan into research tasks — one task per ticker × skill × mode, grouped by pillar, [P]-marked by the different-files-and-no-incomplete-deps rule, with source-refs.

    207 GitHub starsUsed in 1 repo~476 tokens
    Auto-check passed
  • Challenge

    agentii-ai/agentii-investment-intelligence

    Adversarial verification of research theses — cross-run/cross-thesis contradiction via the entity index, pre-mortem (Klarman/Kahneman: assume the loss already happened, reverse the path), inversion…

    207 GitHub stars~735 tokensUpdated 9 days ago
    Auto-check passed
  • Chart Patterns

    agentii-ai/agentii-investment-intelligence

    Chart pattern recognition, price action patterns, candlestick signal bars, pullback bar counting H1/H2/H3/H4, trend channels, micro channels, trading ranges, breakouts, major trend reversals 5-step…

    207 GitHub stars~2k tokensUpdated 9 days ago
    Auto-check passed
  • Converge

    agentii-ai/agentii-investment-intelligence

    Append-only gap closure and the cadence engine for research theses.

    207 GitHub stars~789 tokensUpdated 9 days ago
    Auto-check passed

Categories

Questions about Clarify

What does Clarify do?

The research-domain clarification skill — find underspecified items in a thesis spec.md (prose wrongif, universe rows without rationale, missing budget/expiry/pins, ambiguous pillars), ask the human…. Clarify is an agent skill from agentii-ai/agentii-investment-intelligence.md after every write (Q32 bidirectional maintenance).

When should I use Clarify?

Clarify fits situations like: tasks that involve Essays and academic help.

How do I install Clarify in Claude Code?

Run `npx skills add agentii-ai/agentii-investment-intelligence --skill clarify -a claude-code`. Or copy the skill folder (plugins/vertical-plugins/scenarios/skills/agentii/clarify in agentii-ai/agentii-investment-intelligence) into .claude/skills/clarify in your project. Claude Code loads it when a task matches its description.

How do I install Clarify in Codex?

Run `npx skills add agentii-ai/agentii-investment-intelligence --skill clarify -a codex`. Or copy the skill folder (plugins/vertical-plugins/scenarios/skills/agentii/clarify in agentii-ai/agentii-investment-intelligence) into .agents/skills/clarify in your project. Codex loads it when a task matches its description.

Can I use Clarify 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 agentii-ai/agentii-investment-intelligence --skill clarify -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, .gemini/skills/clarify, .github/skills/clarify and .opencode/skills/clarify in your project.

What does Clarify need to run?

Going by SKILL.md and its folder, Clarify needs the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Clarify 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 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 use?

Clarify 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 use?

About 839 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 155 tokens, read only when the agent opens those files.

What are the alternatives to Clarify?

Skills that share tags, products or a category with Clarify: Academic Paper Strategist (AAASS554/codex-academic-paper-skills, 539 stars), Modeling Paper Rubric and Model Selector (yushui2022/MathModel-Skill, 452 stars), Humanities Thesis (ganzhi-black/humanities-thesis-skill, 630 stars) and Skill Thesis Writer (yanlin-cheng/skill-thesis-writer, 207 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Clarify?

agentii-ai (a GitHub user) maintains it in agentii-ai/agentii-investment-intelligence, which has 207 GitHub stars. The repository holds 79 skills in this directory. The repository was last updated on September 29, 2026.

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