Agent skill

Predictable Behavior First

by Peiiii in Peiiii/nextclaw

仅当任务实际新增或改变 fallback、兼容、降级、救援路径、重试、默认值或 legacy 保留时使用;普通实现没有这些分支时不触发。

MITAuto-check passed

Install Predictable Behavior First

skills CLI
$ npx skills add Peiiii/nextclaw --skill predictable-behavior-first -a claude-code

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

GitHub CLI
$ gh skill install Peiiii/nextclaw predictable-behavior-first --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/Peiiii/nextclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/wiki/skills/architecture/predictable-behavior-first .claude/skills/predictable-behavior-first && 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
predictable-behavior-first
GitHub stars
260
Token cost
~406 tokens
SKILL.md length
112 words
Files
2 (incl. references)
Skills in repo
70
Repo updated
First seen
Licence
MIT

At a glance

仅当任务实际新增或改变 fallback、兼容、降级、救援路径、重试、默认值或 legacy 保留时使用;普通实现没有这些分支时不触发。

  • Works in 7 steps: 写出主合同:发布包、桌面产物、公共 API、配置 schema、持久数据或… → 区分 shipped runtime 与显式 dev mode。 → 判断 fallback 是否掩盖… → …
  • SKILL.md covers 默认立场, 决策流程, 禁止的运行时补丁 and 输出
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Predictable Behavior First is an agent skill from Peiiii/nextclaw. 仅当任务实际新增或改变 fallback、兼容、降级、救援路径、重试、默认值或 legacy 保留时使用;普通实现没有这些分支时不触发。

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

The repository describes itself as: A human-centered long-term AI partner—not a task-centered assistant. The licence is MIT.

Example prompts

  • “/predictable-behavior-first”

Workflow steps

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

  1. 写出主合同:发布包、桌面产物、公共 API、配置 schema、持久数据或 transport。
  2. 区分 shipped runtime 与显式 dev mode。
  3. 判断 fallback 是否掩盖 packaging/config/release/runtime 缺陷;若是,修源合同并增加相应交付 guard。
  4. 判断错误是否来自上游意图或协议;若是,修 producer,不在 consumer 宽容化。
  5. 判断 read-shaped path 是否会被页面加载、路由、轮询、重试、重连或 focus-refetch 自动调用;任何执行副作用都应拆成显式 action。
  6. 协议模式已知时第一次请求就使用正确 contract,不先发错误模式再按错误文本切换。
  7. 仍需兼容时,读取例外政策,证明外部必要性,并冻结触发、范围、信号、owner 和退出条件。

What it can do on your machine

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

Predictable Behavior First loads about 406 tokens when it runs, and up to ~1.1k if it reads all its reference files. Until then it costs about 24 tokens; SKILL.md has 112 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~24
When it runs · the whole SKILL.md, loaded when a task matches
~406
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.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); files beside SKILL.md are not scanned.

SKILL.md

The full file from Peiiii/nextclaw at commit d130133, republished under its MIT licence (© Peiiii). 112 words, ~406 tokens.

Download SKILL.mdSave it as .claude/skills/predictable-behavior-first/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
predictable-behavior-first
description
仅当任务实际新增或改变 fallback、兼容、降级、救援路径、重试、默认值或 legacy 保留时使用;普通实现没有这些分支时不触发。

可预测行为优先

目标是同一输入与安装状态产生同一行为:不靠隐藏环境状态意外成功,也不把发布、配置或协议缺陷伪装成健康。

默认立场

  • fail-fast 优于静默救援,单一事实源优于多级 fallback。
  • dev convenience 必须显式开启;发布产物不得借用 cwd、源码 checkout 或本机偶然资源。
  • 内部重构迁移所有已知调用方并删除旧入口,不为方便保留 alias、proxy、adapter 或双 manager。
  • 未发布中间态不是兼容合同;旧 route/API 只有在承载持久用户数据、已证明外部合同或不可避免的分阶段 rollout 时才保留。
  • 瞬态参数和内部 tool schema 无持久数据/外部合同时直接删除,不留兼容期、迁移或 legacy 分支。
  • 无效的 prompt、schema、协议或上游值应修 producer 并显式拒绝,不在下游用别名或归一化悄悄接受。
  • read/get/list/status/discover/report 必须纯读、可重复且无副作用;加载、注册、授权、写入和外部调用使用显式 action。
  • schema/tool 只表达自身合同,不承载动态 catalog、CLI 教程和 AI 工作流;发现与操作流程归对应 owner。

决策流程

  1. 写出主合同:发布包、桌面产物、公共 API、配置 schema、持久数据或 transport。
  2. 区分 shipped runtime 与显式 dev mode。
  3. 判断 fallback 是否掩盖 packaging/config/release/runtime 缺陷;若是,修源合同并增加相应交付 guard。
  4. 判断错误是否来自上游意图或协议;若是,修 producer,不在 consumer 宽容化。
  5. 判断 read-shaped path 是否会被页面加载、路由、轮询、重试、重连或 focus-refetch 自动调用;任何执行副作用都应拆成显式 action。
  6. 协议模式已知时第一次请求就使用正确 contract,不先发错误模式再按错误文本切换。
  7. 仍需兼容时,读取例外政策,证明外部必要性,并冻结触发、范围、信号、owner 和退出条件。

禁止的运行时补丁

除非用户明确授权短期事故止血且有删除条件,不得在 shipped runtime 中加入:

  • 用 stderr/stdout.includes(...) 识别当前坏版本、打包事故或临时上游故障;
  • “latest release 已坏”等版本/事故签名特判;
  • 扫描多个无关目录直到找到可用资源;
  • 先发送错误 transport,再根据上游报错文本重试真实模式;
  • 自动触发的前端 read path 隐藏 load/register/install/write/external call;
  • 没有真实外部合同的旧 API 转发、双实现或永久 mode flag。

输出

说明主合同、观察/执行属性、自动调用副作用、fallback 是否掩盖缺陷、旧路径是否拥有持久数据或外部合同,以及结论属于:删除、fail-fast、显式 dev-only、或有退出条件的临时兼容。

允许兼容必须同时具备具体必要性、窄范围、可观察信号、cleanup owner 和明确退出事件;缺一项就不保留。

© Peiiii, 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 1 other file (references) in .agents/wiki/skills/architecture/predictable-behavior-first of Peiiii/nextclaw.

  • SKILL.md
  • references/predictable-behavior-policy.md

Open the folder on GitHubat commit d130133

Compare with similar skills

Predictable Behavior First 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.

Predictable Behavior First compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Predictable Behavior First this skillPeiiii/nextclaw260—~406Automated safety check: PassMIT
Inherit Legacy Styleaffaan-m/ECC274k1 repos~2.1kAutomated safety check: NotesMIT
Autopilot Predictruvnet/ruflo74k—~337Automated safety check: PassMIT
Legacy JSthedaviddias/Front-End-Checklist74k—~445Automated safety check: PassMIT
Prediction Market Oracle Researchaffaan-m/ECC274k1 repos~577Automated safety check: PassMIT
Prediction Market Risk Reviewaffaan-m/ECC274k1 repos~471Automated safety check: PassMIT

Similar skills

  • Prevent AI style drift on legacy projects by scanning the codebase for implicit conventions, resolving conflicts with the operator one at a time, and writing an enforceable .ai-style-rules.md…

    274k GitHub starsUsed in 1 repo~2.1k tokens
    Agent WorkflowsAuto-check: notes
  • Autopilot Predict

    ruvnet/ruflo

    Use learned patterns and current state to predict the optimal next action

    74k GitHub stars~337 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Legacy JS

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing slow page loads, heavy assets, or rendering delays related to Avoid serving legacy JavaScript to modern browsers.

    74k GitHub stars~445 tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Research prediction markets as data sources or oracle signals for products, agents, dashboards, and corporate decision intelligence.

    274k GitHub starsUsed in 1 repo~577 tokens
    Knowledge ManagementAuto-check passed
  • Review prediction-market, basket, oracle, and trading-agent workflows for compliance, safety, data-quality, privacy, and execution risk.

    274k GitHub starsUsed in 1 repo~471 tokens
    Data & AnalyticsAuto-check passed
  • Footballbin Predictions

    davila7/claude-code-templates

    Get AI-powered match predictions for Premier League and Champions League including scores, next goal, and corners.

    32k GitHub stars~634 tokensUpdated yesterday
    Auto-check passed

More from Peiiii/nextclaw

All 70 skills in this repo
  • Nextclaw Skin Studio

    Peiiii/nextclaw

    A skill your agent uses when a user wants to browse, apply, inspect, create, refine, switch, or remove a NextClaw skin; wants a personal skin with arbitrary CSS, JavaScript, images, SVG, DOM…

    260 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • A skill your agent uses when a development task needs visible phase tracing, task-level or phase-level Token measurement, model/effort comparison, or a deterministic usage report or local dashboard…

    260 GitHub stars~802 tokensUpdated yesterday
    Auto-check passed
  • 当 NextClaw 产品更新后需要生成、替换、挑毛病或检查官网、GitHub README、用户文档或社交传播中的真实截图、AI 宣传视觉、整页 HTML 宣传预览、社区二维码等对外视觉资产时使用;也用于“更新截图”“重新截一批图”“做宣传页”“生成 campaign 页面”“视觉审稿”“五星挑刺法”或发布前检查视觉资产。普通站点布局开发或只写文章不触发。

    260 GitHub stars~801 tokensUpdated yesterday
    Auto-check passed
  • UI UX Pro Max

    Peiiii/nextclaw

    A skill your agent uses when the user wants professional UI/UX design guidance, design-system generation, UX review, or stack-specific frontend guidance through a bundled local UI/UX Pro Max dataset…

    260 GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Impeccable

    Peiiii/nextclaw

    A skill your agent uses when the user wants distinctive, production-grade frontend design, anti-generic AI aesthetics, UX critique, technical UI audits, or final polish through bundled Impeccable…

    260 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed
  • Curate NextClaw skill resources, including OpenClaw and community sources.

    260 GitHub stars~479 tokensUpdated yesterday
    Auto-check passed

Questions about Predictable Behavior First

What does Predictable Behavior First do?

仅当任务实际新增或改变 fallback、兼容、降级、救援路径、重试、默认值或 legacy 保留时使用;普通实现没有这些分支时不触发。. Predictable Behavior First is an agent skill from Peiiii/nextclaw.

How do I install Predictable Behavior First in Claude Code?

Run `npx skills add Peiiii/nextclaw --skill predictable-behavior-first -a claude-code`. Or copy the skill folder (.agents/wiki/skills/architecture/predictable-behavior-first in Peiiii/nextclaw) into .claude/skills/predictable-behavior-first in your project. Claude Code loads it when a task matches its description.

How do I install Predictable Behavior First in Codex?

Run `npx skills add Peiiii/nextclaw --skill predictable-behavior-first -a codex`. Or copy the skill folder (.agents/wiki/skills/architecture/predictable-behavior-first in Peiiii/nextclaw) into .agents/skills/predictable-behavior-first in your project. Codex loads it when a task matches its description.

Can I use Predictable Behavior First 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 Peiiii/nextclaw --skill predictable-behavior-first -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/predictable-behavior-first, .gemini/skills/predictable-behavior-first, .github/skills/predictable-behavior-first and .opencode/skills/predictable-behavior-first in your project.

What does Predictable Behavior First need to run?

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

Does Predictable Behavior First 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 Predictable Behavior First 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 Predictable Behavior First use?

Predictable Behavior First is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Predictable Behavior First use?

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

What are the alternatives to Predictable Behavior First?

Skills that share tags, products or a category with Predictable Behavior First: Inherit Legacy Style (affaan-m/ECC, 274k stars), Autopilot Predict (ruvnet/ruflo, 74k stars), Legacy JS (thedaviddias/Front-End-Checklist, 74k stars) and Prediction Market Oracle Research (affaan-m/ECC, 274k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Predictable Behavior First?

Peiiii (a GitHub user) maintains it in Peiiii/nextclaw, which has 260 GitHub stars. The repository holds 70 skills in this directory. The repository was last updated on October 6, 2026.

Source: Peiiii/nextclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.