Agent skill

Qiaomu Goal Meta Skill

by joeseesun in joeseesun/qiaomu-goal-meta-skill

Turn vague or complex Codex tasks into strong /goal commands with outcome, verification, constraints, boundaries, iteration policy, completion evidence, and pause/block conditions.

MITAuto-check passed

Install Qiaomu Goal Meta Skill

skills CLI
$ npx skills add joeseesun/qiaomu-goal-meta-skill --skill qiaomu-goal-meta-skill -a claude-code

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

GitHub CLI
$ gh skill install joeseesun/qiaomu-goal-meta-skill qiaomu-goal-meta-skill --agent claude-code

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

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

Facts

Skill name
qiaomu-goal-meta-skill
GitHub stars
900
Token cost
~1.7k tokens
SKILL.md length
672 words
Files
10 (incl. scripts, references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Turn vague or complex Codex tasks into strong /goal commands with outcome, verification, constraints, boundaries, iteration policy, completion evidence, and pause/block conditions.

  • Works in 8 steps: Restate the task as an outcome, not an… → Classify the task using… → Choose best defaults for low-risk… → …
  • The user asks for Codex goal instructions
  • SKILL.md covers Operating Mode, Workflow, Output Contract and Quality Bar, plus 1 more section
  • Runs Python scripts from its folder; calls python3 and make

What it does

Qiaomu Goal Meta Skill is an agent skill from joeseesun/qiaomu-goal-meta-skill. Turn vague or complex Codex tasks into strong /goal commands with outcome, verification, constraints, boundaries, iteration policy, completion evidence, and pause/block conditions. Use when the user asks for Codex goal instructions, Goal 指令, 目标指令, /goal prompts, 中文 Goal 模板, plan-to-goal interviews, success criteria, verification commands, or bounded agent work definitions.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 12 other files, including scripts and reference files (for example `README.md`, `agents/interface.yaml` and `manifest.json`).

The repository describes itself as: Turn vague or complex Codex tasks into strong /goal commands with outcome, verification, constraints, boundaries, iteration policy, completion evide. The licence is MIT.

When your agent uses it

  • The user asks for Codex goal instructions
  • Plan-to-goal interviews
  • Success criteria
  • Verification commands

Example prompts

  • “/qiaomu-goal-meta-skill”

Requirements

  • Python 3

Workflow steps

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

  1. Restate the task as an outcome, not an activity.
  2. Classify the task using references/default-goal-strategy.md: familiar vs unknown domain, low vs high risk, new work vs existing project.
  3. Choose best defaults for low-risk unknowns and write a one-sentence reason.
  4. Identify missing information across the Goal contract
  5. If the task is under-specified, prefer numbered multiple-choice adjustments with defaults. Use references/interview-checklist.md.
  6. For Chinese-first users, produce the Chinese recommended execution goal first, then an English-compatible mirror that preserves the same…
  7. Check the command against references/goal-command-playbook.md.
  8. For file deliverables, run python3 scripts/lint_goal_command.py before calling the goal done.

What it can do on your machine

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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • make

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

  • Network

    Links to these hosts (documentation or services it may open):

    • x.com
    • github.com

    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

Qiaomu Goal Meta Skill loads about 1.7k tokens when it runs, and up to ~8.1k if it reads all its reference files. Until then it costs about 101 tokens; SKILL.md has 672 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from joeseesun/qiaomu-goal-meta-skill at commit f29e018, republished under its MIT licence (© joeseesun). 672 words, ~1,728 tokens.

Download SKILL.mdSave it as .claude/skills/qiaomu-goal-meta-skill/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
qiaomu-goal-meta-skill
description
Turn vague or complex Codex tasks into strong `/goal` commands with outcome, verification, constraints, boundaries, iteration policy, completion evidence, and pause/block conditions. Use when the user asks for Codex goal instructions, Goal 指令, 目标指令, `/goal` prompts, 中文 Goal 模板, plan-to-goal interviews, success criteria, verification commands, or bounded agent work definitions.

Qiaomu Goal Meta Skill

把一个模糊任务,收敛成 Codex 可以持续执行、可以验证、知道何时停止和何时暂停的 /goal 指令。

Copyright (c) 向阳乔木 X: https://x.com/vista8 GitHub: https://github.com/joeseesun/

Operating Mode

Run as a production-lite meta skill.

Default assumptions:

  • The user wants a paste-ready Codex /goal command, not a general prompt.
  • The executable slash command stays /goal. Do not output /目标 as the command unless the user's environment explicitly documents that alias.
  • The first goal block should be the best recommended executable version, not a half-filled template. Users often copy the first draft directly.
  • For Chinese users, output Chinese content and Chinese field names by default while keeping the command prefix /goal.
  • For Chinese users, include both 推荐执行版(中文,可直接复制) and Goal Draft (English-compatible) unless the user asks for one language only.
  • If the task is still vague but low-risk, choose the best conservative defaults and continue. Ask only when the answer changes cost, risk, ownership, or product direction.
  • If the domain is unfamiliar or specialized, create a discovery-first goal that makes the agent inspect authoritative project/docs/runtime evidence before implementation instead of inventing domain rules.
  • If the missing detail is low-risk, make an explicit assumption and continue.
  • Do not start the work described by the goal unless the user explicitly asks. This skill creates the goal instruction.
  • Prefer concrete verification commands and artifacts over vague confidence phrases.
  • Prefer narrow write boundaries and explicit forbidden paths over broad permission.
  • Treat Stop when and Pause if as part of the same completion/blocking contract.

Workflow

  1. Restate the task as an outcome, not an activity.
  2. Classify the task using references/default-goal-strategy.md: familiar vs unknown domain, low vs high risk, new work vs existing project.
  3. Choose best defaults for low-risk unknowns and write a one-sentence reason.
  4. Identify missing information across the Goal contract:
    • success criteria
    • verification commands, artifacts, or evidence
    • constraints that must not change
    • allowed writes and forbidden paths
    • iteration policy
    • completion evidence
    • blocked stop conditions, human decisions, or budget caps
  5. If the task is under-specified, prefer numbered multiple-choice adjustments with defaults. Use references/interview-checklist.md.
  6. For Chinese-first users, produce the Chinese recommended execution goal first, then an English-compatible mirror that preserves the same meaning and keeps English field labels.
  7. Check the command against references/goal-command-playbook.md.
  8. For file deliverables, run python3 scripts/lint_goal_command.py <file> before calling the goal done.
Show full SKILL.md (299 more words)Show less

Output Contract

When enough information is known, output the best recommended command first. Do not leave placeholders in real output.

text
/goal Create a first-version local MVP for the requested task, inspect project-provided commands before changing code, implement the core user-visible workflow, and keep unrelated systems unchanged.
Verification: run the smallest project-provided checks, start the local app or relevant runtime, complete the core workflow once, and capture logs/screenshots or command output as evidence.
Constraints: do not add accounts, paid services, production changes, destructive operations, or unrelated features unless requested.
Boundaries: write only inside the new project directory or the directly related existing project files.
Iteration policy: implement one focused workflow at a time, rerun checks after meaningful changes, inspect logs before retrying, and make at most 3 focused improvement rounds before reporting remaining risks.
Stop when: the core workflow is proven by runtime evidence and checks pass or missing checks are explicitly reported.
Pause if: credentials, payments, production data, destructive changes, legal/medical/financial decisions, copyrighted assets, or unclear ownership is required.

For Chinese-first users, prefer this equivalent shape:

text
/goal 基于用户需求创建第一版本地 MVP,先读取项目已有命令和约束,实现核心用户可见流程,并避免改动无关系统。
验证:运行项目提供的最小相关检查,启动本地应用或对应运行环境,完整走通一次核心流程,并用日志、截图或命令输出作为证据。
约束:不加入账号、付费服务、生产变更、破坏性操作或无关功能,除非用户明确要求。
边界:只写入新项目目录,或只修改现有项目中与该功能直接相关的文件。
迭代策略:一次实现一个聚焦工作流,每次有意义改动后重跑检查,重试前先读日志,最多做 3 轮聚焦改进后报告剩余风险。
完成条件:核心流程有运行证据证明可用,检查通过或明确说明缺少配置。
暂停条件:需要凭证、付费、生产数据、破坏性操作、法律/医疗/金融判断、版权素材或所有权不清时暂停。

When the task is vague, output:

  1. 推荐执行版(中文,可直接复制): the best default /goal.
  2. 默认选择理由: one concise sentence.
  3. 可选调整: numbered choices with recommended defaults and short option labels.
  4. 你可以直接回复: an example such as 按默认 or 1B 2A 3C.
  5. Goal Draft (English-compatible): a faithful English-compatible mirror with English field labels.

If the user writes in English, output only the English-compatible draft unless they ask for Chinese too.

Do not output long generic coaching unless the user asks for explanation.

Quality Bar

A strong goal:

  • has one concrete outcome
  • names exact checks or evidence
  • protects unrelated files, user data, secrets, and default branches
  • defines the write boundary
  • tells the agent how to iterate after failures
  • says when to stop because completion is proven
  • says when to pause because a human decision, credential, account state, budget, or repeated blocker is required

Reject or revise a goal that:

  • says only make it better, finish this, or fix bugs
  • lacks verification
  • lets the agent edit the whole machine or repo without reason
  • asks for repeated retries without a new source of evidence
  • has no pause condition for external auth, secrets, payments, destructive actions, or ambiguous product decisions
  • leaves placeholders such as [Outcome] in user-facing executable drafts
  • treats vague words such as 高级, 有质感, or professional as verification instead of translating them into screenshots, runtime checks, review criteria, or iteration rules

Reference Files

  • references/goal-command-playbook.md: the core /goal template, when to use it, examples, and anti-patterns.
  • references/default-goal-strategy.md: lazy-user defaults, unknown-domain discovery, risk classification, and direct-copy output rules.
  • references/interview-checklist.md: question bank for turning vague tasks into strong goals.
  • scripts/lint_goal_command.py: lightweight checker for required /goal labels and unresolved placeholders.

© joeseesun, MIT. 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 9 other files (scripts, references) in the repository root of joeseesun/qiaomu-goal-meta-skill.

  • SKILL.md
  • .gitignore
  • LICENSE
  • README.md
  • agents/interface.yaml
  • manifest.json
  • references/default-goal-strategy.md
  • references/goal-command-playbook.md
  • references/interview-checklist.md
  • scripts/lint_goal_command.py

Open the folder on GitHubat commit f29e018

Compare with similar skills

Qiaomu Goal Meta Skill 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.

Qiaomu Goal Meta Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Qiaomu Goal Meta Skill this skilljoeseesun/qiaomu-goal-meta-skill900—~1.7kAutomated safety check: PassMIT
Goalscodewhale-hq/Codewhale41k—~273Automated safety check: PassMIT
Agent Goal Plannerruvnet/ruflo74k2 repos~842Automated safety check: PassMIT
Goal Planruvnet/ruflo74k—~807Automated safety check: NotesMIT
Goal Objective DrafterQwenLM/qwen-code28k—~3.5kAutomated safety check: PassApache-2.0
Goal Loopsickn33/agentic-awesome-skills47k1 repos~2.6kAutomated safety check: PassMIT

Similar skills

  • Goals

    codewhale-hq/Codewhale

    Set, review, and update the user's goals. An agent skill from codewhale-hq/Codewhale.

    41k GitHub stars~273 tokensUpdated today
    Auto-check passed
  • Agent Goal Planner

    ruvnet/ruflo

    Agent skill for goal-planner - invoke with $agent-goal-planner

    74k GitHub starsUsed in 2 repos~842 tokens
    Auto-check passed
  • Goal Plan

    ruvnet/ruflo

    Create and execute Goal-Oriented Action Plans (GOAP) with precondition analysis, cost optimization, and adaptive replanning

    74k GitHub stars~807 tokensUpdated yesterday
    Auto-check: notes
  • Goal Objective Drafter

    QwenLM/qwen-code

    Turns a vague intention into a /goal objective with one outcome, numbered yes-or-no checks, guardrails, a budget and a block protocol, without starting the work.

    28k GitHub stars~3.5k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Goal Loop

    sickn33/agentic-awesome-skills

    Draft and explain persistent goal-loop prompts for long-running agent work with clear stop conditions.

    47k GitHub starsUsed in 1 repo~2.6k tokens
    Agent WorkflowsAuto-check passed
  • Agent skill for code-goal-planner - invoke with $agent-code-goal-planner

    74k GitHub starsUsed in 2 repos~3.6k tokens
    Agent WorkflowsAuto-check passed

Questions about Qiaomu Goal Meta Skill

What does Qiaomu Goal Meta Skill do?

Turn vague or complex Codex tasks into strong /goal commands with outcome, verification, constraints, boundaries, iteration policy, completion evidence, and pause/block conditions. Qiaomu Goal Meta Skill is an agent skill from joeseesun/qiaomu-goal-meta-skill. Turn vague or complex Codex tasks into strong /goal commands with outcome, verification, constraints, boundaries, iteration policy, completion evidence, and pause/block conditions.

When should I use Qiaomu Goal Meta Skill?

Qiaomu Goal Meta Skill fits situations like: the user asks for Codex goal instructions; plan-to-goal interviews; success criteria; verification commands.

How do I install Qiaomu Goal Meta Skill in Claude Code?

Run `npx skills add joeseesun/qiaomu-goal-meta-skill --skill qiaomu-goal-meta-skill -a claude-code`. Or copy the skill folder (the joeseesun/qiaomu-goal-meta-skill repository) into .claude/skills/qiaomu-goal-meta-skill in your project. Claude Code loads it when a task matches its description.

How do I install Qiaomu Goal Meta Skill in Codex?

Run `npx skills add joeseesun/qiaomu-goal-meta-skill --skill qiaomu-goal-meta-skill -a codex`. Or copy the skill folder (the joeseesun/qiaomu-goal-meta-skill repository) into .agents/skills/qiaomu-goal-meta-skill in your project. Codex loads it when a task matches its description.

Can I use Qiaomu Goal Meta Skill 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 joeseesun/qiaomu-goal-meta-skill --skill qiaomu-goal-meta-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/qiaomu-goal-meta-skill, .gemini/skills/qiaomu-goal-meta-skill, .github/skills/qiaomu-goal-meta-skill and .opencode/skills/qiaomu-goal-meta-skill in your project.

What does Qiaomu Goal Meta Skill need to run?

Going by SKILL.md and its folder, Qiaomu Goal Meta Skill needs Python for the scripts in its folder and the command-line tools its instructions call (python3 and make). Our summary lists: Python 3.

Does Qiaomu Goal Meta Skill access the network?

SKILL.md names 2 domains. As links in the text: x.com and github.com. This is read from the text; nothing was executed.

Is Qiaomu Goal Meta Skill 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Qiaomu Goal Meta Skill use?

Qiaomu Goal Meta Skill is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Qiaomu Goal Meta Skill use?

About 1.7k tokens (SKILL.md is roughly 6.9k 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 6.4k tokens, read only when the agent opens those files.

What are the alternatives to Qiaomu Goal Meta Skill?

Skills that share tags, products or a category with Qiaomu Goal Meta Skill: Goals (codewhale-hq/Codewhale, 41k stars), Agent Goal Planner (ruvnet/ruflo, 74k stars), Goal Plan (ruvnet/ruflo, 74k stars) and Goal Objective Drafter (QwenLM/qwen-code, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Qiaomu Goal Meta Skill?

joeseesun (a GitHub user) maintains it in joeseesun/qiaomu-goal-meta-skill, which has 900 GitHub stars. The repository was last updated on June 11, 2026.

Source: joeseesun/qiaomu-goal-meta-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.