cc-switch-web: Skill for Claude Code

.pi/skills/xirang-propose/SKILL.md

xirang-propose is a skill for Claude Code, Codex from cp-yu/cc-switch-web. It costs 48 tokens per session (3,054 once invoked), scanned A, original, MIT.

A planning skill that turns a requested software change into a proposal, design, specifications, and implementation tasks. Xirang is a structured record of intended system parts, rules, and relationships.

In plain words
What is it for?
It is for describing a new feature or update and producing the planning files needed to build it.
Why use it?
It gives implementation a written plan instead of leaving requirements and design decisions scattered in conversation.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

This is cp-yu/cc-switch-web's own configuration. It tells Claude Code and Codex how to work on cc-switch-web itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything cc-switch-web configures →

Reuse

Borrowing it

Nothing to install: this file belongs to cp-yu/cc-switch-web. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/cp-yu/cc-switch-web/main/.pi/skills/xirang-propose/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/cp-yu/cc-switch-web

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for xirang-propose

README.md
[![agentmods](https://agentmods.dev/badge/skills/cp-yu/cc-switch-web/xirang-propose/github.svg)](https://agentmods.dev/skills/cp-yu/cc-switch-web/xirang-propose)
Your own site
<a href="https://agentmods.dev/skills/cp-yu/cc-switch-web/xirang-propose"><img src="https://agentmods.dev/badge/skills/cp-yu/cc-switch-web/xirang-propose/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for xirang-propose

Your own site · 80×15
<a href="https://agentmods.dev/skills/cp-yu/cc-switch-web/xirang-propose"><img src="https://agentmods.dev/badge/skills/cp-yu/cc-switch-web/xirang-propose.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 48 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,054 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00048 $0.03054
Opus 5.5 $0.00019 $0.01222
Sonnet 5.5 $0.00010 $0.00611
Haiku 4.5 $0.00005 $0.00305

Measured 1mo ago against content hash 9949b4b1c20a, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

xirang-propose scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.pi/skills/xirang-propose/SKILL.md · 110 lines

How it starts

The opening of the file, as written. The whole thing — 110 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Propose a new change or update an existing change, generating all artifacts needed for implementation.

Xirang Philosophy

  1. Xirang is a structured representation of human intent that an Agent can compile.
  2. One Xirang Semantic Model is persisted as a single whole in the four partitions metamodel/, elements/, relationships/, and views/; a Semantic Delta uses the same four partitions and adds operation.
  3. A change reconciles a Semantic Delta toward the target steady state. proposal.md, design.md, and tasks.md are compilation scaffolding, not competing sources of truth.
  4. The Xirang Semantic Model is complete only when an Agent need not guess decisions that affect element hierarchy, contracts, or relationships.
  5. The Agent acts like a compiler and faithfully translates authorized human intent. Existing code is current implementation evidence and MUST NOT silently override the Xirang Semantic Model.

Xirang Semantic Model Context

  • Resolve the absolute Project Root, then load the Semantic Model from .xirang/model/{metamodel,elements,relationships,views}/ and locate the unique Project Root Element, whose parent is null.
  • Use identity as the only way to reference a semantic object. FQN, syntax position, and derived local names are generation artifacts and never appear in a persistent source.
  • Read relevant parent and children as abstraction/refinement context. Do not assume a fixed element-kind hierarchy or treat nesting as ownership.
  • An Element Contract is the body of its Element unit: one Element has at most one Contract, expressed as ## Requirements, and whether a Contract is required comes from the contract field of its Element Kind.
  • Use xirang arch query <identity> --relations --depth <n> --json for parent, children, and incoming/outgoing semantic relationships; add --contract to inline the complete Element Contract.
  • Default unit naming is elements/<identity>.md, metamodel/<kind identity>.md, views/<view identity>.md, and relationships/<relationship kind identity>.yaml grouped by Relationship Kind; a change reuses these names under .xirang/changes/<name>/. Directory and file names carry no model semantics: every entry declares its own entity and identity, and loading locates entries by those, never by path.
  • Treat code paths, symbols, imports, and calls from CodeGraph or ACE/rg/read as current implementation evidence only; do not promote them to elements or relationships without declared model intent.
  • If the model is missing, report Semantic Model unavailable. If it is incomplete or unsupported, identify the root, identity, contract, or relationship gap.
  • A read-only exploration MAY degrade to available model and code evidence with the limitation disclosed. Workflows that compile or write semantics MUST stop when required model context is missing or incomplete; never treat a missing collection as complete and empty.

Element Contract Semantics

  • Element Contract SHALL 完整表达宿主 Element 在自身抽象层级承担的职责、保证、约束与行为;children 可以进一步精化或共同实现这些承诺,父子 Elements 可以在各自层级表达相互覆盖的完整语义。
  • Requirement SHALL 以稳定 identity 表达一项可独立演进的规范承诺。以该承诺能否独立新增、修改或移除判断边界,不得按句子、分句、SHALL 数量或目标条数机械拆分。只复述 Declaration summary 或 sibling Requirements 语义并集且不增加规范承诺的内容不形成 Requirement;独立的不变量、顺序、原子性、一致性或完成条件应保留。
  • Scenario SHALL 是具有规范约束力的 Requirement 组成,只具体化宿主 Requirement 在特定条件下的行为,不得引入可独立演进的承诺。Scenarios 不默认穷尽 Requirement 的全部适用情况,Scenario 不作为独立 Semantic Delta Entry,其变化由宿主 Requirement 的完整目标内容表达。

Workflow Stage

Aspect Value
Stage PROPOSE - Artifact generation (no implementation)
Allowed Generate proposal, design, tasks, and the four-partition Semantic Delta units in .xirang/changes//
Forbidden Implement code, modify project files outside the selected change directory

Read the full file on GitHub · 110 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 110 lines · 48 tokens per session scan A 9949b4b1c20a

Subscribe to this mod's changes

xirang-propose is a skill published in the GitHub repository cp-yu/cc-switch-web (47 stars, last pushed 1mo ago), licensed MIT. It adds 48 tokens to every session and 3,054 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-12.

Related

Other skills, from other repositories

local-ai-agents

Build local-first AI agents that run entirely on a developer workstation with Microsoft Foundry Local and Qwen function-calling models. Covers Small Language Models (SLMs), the OpenAI-compatible local endpoint, sandboxed local tools, local RAG with Chroma, local MCP servers, hybrid cloud/local routing, and the…

microsoft/ai-agents-for-beginners · 200 tokens

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.

obra/superpowers · 21 tokens

next-cache-components-adoption

Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces. Use when the user wants to enable, adopt, or migrate to Cache Components, flip the cacheComponents flag, work through a flood of blocking-prerender / instant validation errors, run the cache-components-instant-false codemod, or…

vercel/next.js · 95 tokens

chat-pet-sprite-creation

Use when creating or changing VS Code chat pet sprite art, sprite sheets, state animations, eye treatments, Stable/Insiders variants, or pet transitions under src/vs/workbench/contrib/chat/browser/widget/media/chatPet.

microsoft/vscode · 53 tokens

cpu-profile-analysis

Analyze V8/Chrome CPU profiles (.cpuprofile) and DevTools trace files (Trace-.json). Use when: profiling performance, investigating slow functions, comparing code paths, finding bottlenecks, analyzing timeToRequest, understanding call trees from sampling profiler data, analyzing layout/paint/rendering, investigating…

microsoft/vscode · 71 tokens

insight-error-page

Write or audit an insight-kind error page for the Next.js dev overlay. Use when creating a new errors/ .mdx page, auditing an existing one, or checking that a page matches the framework fix cards. Covers page structure, title alignment, FixCard cards with Copy prompt button, code snippets, terminology verification…

vercel/next.js · 83 tokens