Agent skill

Intent Aligner

by haibarazz in haibarazz/awesome-codex-research

在实现、实验、写作或规划之前进行轻量级意图对齐。当用户明确要求对齐意图、复述需求、确认理解时使用;当请求存在歧义、两种合理的实现方式会产生明显不同结果时,也应在开始任何中小型实现/实验/写作任务前主动使用。对于意图完全清晰的一步式小请求不要使用,也不要进入完整的 Plan Mode。

No licenceAuto-check passedAgent Workflows

Install Intent Aligner

skills CLI
$ npx skills add haibarazz/awesome-codex-research --skill intent-aligner -a claude-code

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

GitHub CLI
$ gh skill install haibarazz/awesome-codex-research intent-aligner --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/haibarazz/awesome-codex-research.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/intent-aligner .claude/skills/intent-aligner && 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
intent-aligner
GitHub stars
100
Token cost
~593 tokens
SKILL.md length
102 words
Files
2
Skills in repo
9
Repo updated
First seen
Licence
None found

At a glance

在实现、实验、写作或规划之前进行轻量级意图对齐。当用户明确要求对齐意图、复述需求、确认理解时使用;当请求存在歧义、两种合理的实现方式会产生明显不同结果时,也应在开始任何中小型实现/实验/写作任务前主动使用。对于意图完全清晰的一步式小请求不要使用,也不要进入完整的 Plan Mode。

  • Works in 4 steps: 先查证,再提问。… → 区分事实与猜测。… → 优先质疑错误前提。… → …
  • Tasks that involve Planning
  • SKILL.md covers 核心原则(所有模式通用), 第一步:判断对齐规模, 快速对齐 and 迭代对齐, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Intent Aligner is an agent skill from haibarazz/awesome-codex-research. 在实现、实验、写作或规划之前进行轻量级意图对齐。当用户明确要求对齐意图、复述需求、确认理解时使用;当请求存在歧义、两种合理的实现方式会产生明显不同结果时,也应在开始任何中小型实现/实验/写作任务前主动使用。对于意图完全清晰的一步式小请求不要使用,也不要进入完整的 Plan Mode。

Its SKILL.md is about 590 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Agent Workflows, covering Planning.

When your agent uses it

  • Tasks that involve Planning

Example prompts

  • “/intent-aligner”

Workflow steps

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

  1. 先查证,再提问。 如果一个事实可以从仓库、文档、配置、历史消息或可见文件中查到,就自己去查,不要问用户。
  2. 区分事实与猜测。 陈述假设时,标注哪些是查证过的(已查证),哪些是猜的(猜测)。用户应该一眼就能看出哪些假设是可靠的。
  3. 优先质疑错误前提。 如果请求建立在技术上错误或有风险的前提之上,先直接指出,再问细节问题。质疑前提的优先级高于打磨细节。
  4. 每个问题都必须能改变下一步行动。 如果答案不会影响你接下来做什么,就不要问。

What it can do on your machine

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

Intent Aligner loads about 593 tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 102 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
~593

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 102 words (~593 tokens).

name
intent-aligner

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in skills/intent-aligner of haibarazz/awesome-codex-research.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit e3ca125

Compare with similar skills

Intent Aligner 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.

Intent Aligner compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Intent Aligner this skillhaibarazz/awesome-codex-research100—~593Automated safety check: PassNone
Executing Plans Inlineobra/superpowers297k2 repos~5.1kAutomated safety check: PassMIT
Interview Meaddyosmani/agent-skills103k6 repos~3.8kAutomated safety check: PassMIT
OpenSpec Guided OnboardingFission-AI/OpenSpec71k1 repos~4.5kAutomated safety check: PassMIT
Writing Plansgeeksblabla/stateofdev.ma16357 repos~661Automated safety check: PassNone
Subagent Driven DevelopmentAsvarox/allkaraoke26137 repos~1.2kAutomated safety check: PassNone

Similar skills

  • Executing Plans Inline

    obra/superpowers

    Has the agent carry out an implementation plan itself, task by task in the current session, keeping a ledger, proving each step with a test and ending with one whole-branch review.

    297k GitHub starsUsed in 2 repos~5.1k tokens
    Agent WorkflowsAuto-check passed
  • Interview Me

    addyosmani/agent-skills

    Asks one question at a time, each with a best guess attached, until the agent is about 95 percent sure what you really want, before any plan, spec or code.

    103k GitHub starsUsed in 6 repos~3.8k tokens
    Agent WorkflowsAuto-check passed
  • OpenSpec Guided Onboarding

    Fission-AI/OpenSpec

    Walks you through a complete OpenSpec workflow cycle with narration while doing real work in your codebase.

    71k GitHub starsUsed in 1 repo~4.5k tokens
    Agent WorkflowsAuto-check passed
  • Writing Plans

    geeksblabla/stateofdev.ma

    A skill your agent uses when design is complete and you need detailed implementation tasks for engineers with zero codebase context - creates comprehensive implementation plans with exact file…

    163 GitHub starsUsed in 57 repos~661 tokens
    Agent WorkflowsAuto-check passed
  • Subagent Driven Development

    Asvarox/allkaraoke

    A skill your agent uses when executing implementation plans with independent tasks in the current session

    261 GitHub starsUsed in 37 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • Planning With Files

    jd-opensource/JoySafeter

    Implements Manus-style file-based planning for complex tasks.

    313 GitHub starsUsed in 19 repos~1.8k tokens
    Agent WorkflowsAuto-check: notes

More from haibarazz/awesome-codex-research

All 9 skills in this repo
  • Autoresearch

    haibarazz/awesome-codex-research

    Run rigorous end-to-end autonomous ML and AI research after a user provides a dataset, target, and research budget.

    100 GitHub stars~2.2k tokensUpdated 16 days ago
    Auto-check passed
  • Cds Method Innovation

    haibarazz/awesome-codex-research

    Guide a complete baseline-first ML or computational data-science method-innovation project, from workspace and direction discovery through finding and running common and recent baselines, diagnosing…

    100 GitHub stars~715 tokensUpdated 16 days ago
    Auto-check passed
  • Autodl Remote

    haibarazz/awesome-codex-research

    A skill your agent uses when the host coding agent should control an AutoDL or SSH server from the local machine, run remote commands, and explicitly upload or download selected files.

    100 GitHub stars~2.7k tokensUpdated 16 days ago
    Auto-check passed
  • Autodl Remote Tmux

    haibarazz/awesome-codex-research

    A skill your agent uses when AutoDL Remote should run or monitor long remote jobs through tmux panes.

    100 GitHub stars~666 tokensUpdated 16 days ago
    Auto-check passed
  • Auto Exp

    haibarazz/awesome-codex-research

    Plan, execute, monitor, verify, compare, and document reproducible machine-learning experiments.

    100 GitHub stars~1.4k tokensUpdated 16 days ago
    Auto-check passed
  • Research Literature Review

    haibarazz/awesome-codex-research

    面向信息系统计算设计科学(CDS)研究,根据用户的数据、研究情境与研究问题,分别识别问题/理论视角和技术/算法两条文献对话线,检索并核验全文,制作可追溯的文献对话地图,最终澄清研究的最近邻、理论祖先、方法缺口与可辩护定位。适用于选题定位、相关工作规划、方法定位和后续综述;核心不是代写文献综述。

    100 GitHub stars~558 tokensUpdated 16 days ago
    Auto-check passed

Categories

Questions about Intent Aligner

What does Intent Aligner do?

在实现、实验、写作或规划之前进行轻量级意图对齐。当用户明确要求对齐意图、复述需求、确认理解时使用;当请求存在歧义、两种合理的实现方式会产生明显不同结果时,也应在开始任何中小型实现/实验/写作任务前主动使用。对于意图完全清晰的一步式小请求不要使用,也不要进入完整的 Plan Mode。. Intent Aligner is an agent skill from haibarazz/awesome-codex-research.

When should I use Intent Aligner?

Intent Aligner fits situations like: tasks that involve Planning.

How do I install Intent Aligner in Claude Code?

Run `npx skills add haibarazz/awesome-codex-research --skill intent-aligner -a claude-code`. Or copy the skill folder (skills/intent-aligner in haibarazz/awesome-codex-research) into .claude/skills/intent-aligner in your project. Claude Code loads it when a task matches its description.

How do I install Intent Aligner in Codex?

Run `npx skills add haibarazz/awesome-codex-research --skill intent-aligner -a codex`. Or copy the skill folder (skills/intent-aligner in haibarazz/awesome-codex-research) into .agents/skills/intent-aligner in your project. Codex loads it when a task matches its description.

Can I use Intent Aligner 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 haibarazz/awesome-codex-research --skill intent-aligner -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/intent-aligner, .gemini/skills/intent-aligner, .github/skills/intent-aligner and .opencode/skills/intent-aligner in your project.

What does Intent Aligner need to run?

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

Does Intent Aligner 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 Intent Aligner 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 Intent Aligner use?

No licence was found for Intent Aligner or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Intent Aligner use?

About 593 tokens (SKILL.md is roughly 2.4k 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 Intent Aligner?

Skills that share tags, products or a category with Intent Aligner: Executing Plans Inline (obra/superpowers, 297k stars), Interview Me (addyosmani/agent-skills, 103k stars), OpenSpec Guided Onboarding (Fission-AI/OpenSpec, 71k stars) and Writing Plans (geeksblabla/stateofdev.ma, 163 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Intent Aligner?

haibarazz (a GitHub user) maintains it in haibarazz/awesome-codex-research, which has 100 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on September 23, 2026.

Source: haibarazz/awesome-codex-research on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.