Agent skill

Ecc Guide

by affaan-m in affaan-m/ECC

在回答之前先读取仓库的实时状态,引导用户了解 ECC 当前的 agents、skills、命令、hooks、规则、安装配置档案以及项目接入流程。

MITAuto-check passedAgent Workflows

Install Ecc Guide

skills CLI
$ npx skills add affaan-m/ECC --skill ecc-guide -a claude-code

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

GitHub CLI
$ gh skill install affaan-m/ECC ecc-guide --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/affaan-m/ECC.git skills-src && mkdir -p .claude/skills && cp -r skills-src/docs/zh-CN/skills/ecc-guide .claude/skills/ecc-guide && 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
ecc-guide
GitHub stars
276k
Token cost
~837 tokens
SKILL.md length
155 words
Files
1
Skills in repo
673
Repo updated
First seen
Licence
MIT

At a glance

在回答之前先读取仓库的实时状态,引导用户了解 ECC 当前的 agents、skills、命令、hooks、规则、安装配置档案以及项目接入流程。

  • Works in 4 steps: 用什么 → 为什么合适 → 要查看的确切文件或命令 → …
  • Agent Workflows work in your project
  • SKILL.md covers 何时使用, 核心原则, 仓库地图 and 回复风格, plus 3 more sections
  • Calls node, npm and rg

What it does

Ecc Guide is an agent skill from affaan-m/ECC. 在回答之前先读取仓库的实时状态,引导用户了解 ECC 当前的 agents、skills、命令、hooks、规则、安装配置档案以及项目接入流程。

Its SKILL.md is about 840 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows. The repository describes itself as: The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond. The licence is MIT.

When your agent uses it

  • Agent Workflows work in your project

Example prompts

  • “/ecc-guide”

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 ef648e0. 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:

    • node
    • npm
    • rg

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

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    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

Ecc Guide loads about 837 tokens when it runs. Until then it costs about 21 tokens; SKILL.md has 155 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~21
When it runs · the whole SKILL.md, loaded when a task matches
~837

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 affaan-m/ECC at commit ef648e0, republished under its MIT licence (© affaan-m). 155 words, ~837 tokens.

Download SKILL.mdSave it as .claude/skills/ecc-guide/SKILL.md (or your agent's skills folder).
name
ecc-guide
description
在回答之前先读取仓库的实时状态,引导用户了解 ECC 当前的 agents、skills、命令、hooks、规则、安装配置档案以及项目接入流程。
origin
community

ECC 指南

当用户需要帮助来理解、浏览、安装 ECC 或在其中做选择时,使用此技能。

何时使用

当用户出现以下情况时使用此技能:

  • 询问 ECC 包含哪些内容
  • 需要帮助查找某个 skill、命令、agent、hook、规则或安装配置档案
  • 刚接触本仓库,需要一条引导路径
  • 询问"如何用 ECC 做 X?"
  • 询问哪些 ECC 组件适合某个项目
  • 需要简单了解命令、skills、agents、hooks 和规则之间的关系
  • 对安装路径、重复安装、重置/卸载或选择性安装选项感到困惑

核心原则

依据当前文件回答,而不是凭记忆。ECC 变化很快,硬编码的目录数量、功能列表和安装说明都会过时。

当 ECC 仓库可用时,先检查相关文件再给出具体答案:

bash
node scripts/ci/catalog.js --json
find skills -maxdepth 2 -name SKILL.md | sort
find commands -maxdepth 1 -name '*.md' | sort
find agents -maxdepth 1 -name '*.md' | sort
node scripts/install-plan.js --list-profiles
node scripts/install-plan.js --list-components --json

只读取回答用户问题所需的最小文件集。

仓库地图

  • README.md:安装路径、卸载/重置指引、对外定位、常见问题
  • AGENTS.md:贡献者指引和项目结构
  • agent.yaml:导出的 gitagent 接口和命令列表
  • commands/:持续维护的斜杠命令兼容垫片
  • skills/*/SKILL.md:可复用的工作流和领域手册
  • agents/*.md:用于委派的子代理角色提示词
  • rules/:语言规则和运行环境规则
  • hooks/README.md、hooks/hooks.json、scripts/hooks/:hook 行为和安全门控
  • manifests/install-*.json:选择性安装的模块、组件、配置档案和目标支持
  • docs/:运行环境指南、架构笔记、翻译文档、发布文档

回复风格

先给答案,再给下一步动作。大多数用户不需要完整的目录倾倒。

良好的首次回复结构:

  1. 用什么
  2. 为什么合适
  3. 要查看的确切文件或命令
  4. 一个后续命令或问题

避免:

  • 默认列出所有 skill 或命令
  • 重复 README 的大段内容
  • 在已有 skill 优先路径时仍推荐已退役的命令垫片
  • 未检查文件系统就声称某个组件存在
  • 在托管安装器支持目标环境时,用手动复制命令代替安装指引

常见任务

新用户入门

给出一份简短菜单:

  • 安装或重置 ECC
  • 为项目挑选 skills
  • 理解命令与 skills 的区别
  • 检查 hooks 和安全行为
  • 运行一次运行环境审计
  • 查找某个特定工作流

安装/重置指向 README.md,项目级接入指向 /project-init。

功能发现

对于"我该用什么来做 X?":

  1. 搜索 skills/、commands/ 和 agents/。
  2. 优先把 skills 作为主要工作流入口。
  3. 仅当命令是持续维护的兼容垫片、或用户明确想要斜杠命令行为时才使用命令。
  4. 当委派有价值时提及 agents。

有用的搜索:

bash
rg -n "<query>" skills commands agents docs
find skills -maxdepth 2 -name SKILL.md | sort
安装指引

使用托管安装路径:

bash
node scripts/install-plan.js --list-profiles
node scripts/install-plan.js --profile minimal --target claude --json
node scripts/install-apply.js --profile minimal --target claude --dry-run

针对特定 skill 的安装:

bash
node scripts/install-plan.js --skills <skill-id> --target claude --json
node scripts/install-apply.js --skills <skill-id> --target claude --dry-run

提醒用户不要同时叠加插件安装和完整的手动/档案安装,除非他们有意要重复的组件面。

项目接入

当用户想为目标仓库配置 ECC 时,使用 /project-init。预期顺序为:

  1. 从项目文件检测技术栈
  2. 生成一份 dry-run 安装计划
  3. 检查现有的 CLAUDE.md 和设置文件
  4. 在应用更改前先询问
  5. 保持生成的指引精简且针对该仓库
故障排查

先询问目标运行环境和安装路径,然后检查:

  • 插件安装元数据
  • .claude/、.cursor/、.codex/、.gemini/、.opencode/、.codebuddy/、.joycode/ 或 .qwen/
  • hooks/hooks.json
  • 安装状态文件
  • 相关的命令/skill 文件

针对仓库健康度,建议:

bash
npm run harness:audit -- --format text
npm run observability:ready
npm test

输出模板

简短推荐
text
Use <skill-or-command>. It fits because <reason>.

Canonical file: <path>
Verify with: <command>
Next: <one concrete action>
搜索结果
text
Best matches:
- <path>: <why it matters>
- <path>: <why it matters>

Recommendation: <which one to use first and why>
安装计划摘要
text
Detected: <stack evidence>
Target: <harness>
Plan: <profile/modules/skills>
Dry run: <command>
Would change: <paths>
Needs approval before apply: <yes/no>

相关入口

  • /project-init:面向目标仓库的技术栈感知接入计划
  • /harness-audit:确定性的就绪度评分卡
  • /skill-health:skill 质量审查
  • /skill-create:从本地 git 历史生成新 skill
  • /security-scan:检查 Claude/OpenCode 配置安全性

© affaan-m, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in docs/zh-CN/skills/ecc-guide of affaan-m/ECC.

Open the folder on GitHubat commit ef648e0

Compare with similar skills

Ecc Guide 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.

Ecc Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ecc Guide this skillaffaan-m/ECC276k—~837Automated safety check: PassMIT
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
Hook Development for Claude Code Pluginsanthropics/claude-plugins-official38k10 repos~4.1kAutomated safety check: NotesApache-2.0
Using Superpowersfarm-fe/farm5.6k35 repos~1.4kAutomated safety check: PassMIT
Executing Plans Inlineobra/superpowers297k2 repos~5.1kAutomated safety check: PassMIT
Skill CreatorAzure/azqr79589 repos~8.2kAutomated safety check: PassApache-2.0

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • Hook Development for Claude Code Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.

    38k GitHub starsUsed in 10 repos~4.1k tokens
    Agent WorkflowsAuto-check: notes
  • Using Superpowers

    farm-fe/farm

    A skill your agent uses when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions

    5.6k GitHub starsUsed in 35 repos~1.4k tokens
    Agent WorkflowsAuto-check passed
  • 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
  • Skill Creator

    Azure/azqr

    Official

    Create new skills, modify and improve existing skills, and measure skill performance.

    795 GitHub starsUsed in 89 repos~8.2k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Agent Development

    anthropics/claude-plugins-official

    Official

    Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.

    38k GitHub starsUsed in 7 repos~2.8k tokens
    Agent WorkflowsAuto-check passed

More from affaan-m/ECC

All 673 skills in this repo
  • Skill Stocktake

    affaan-m/ECC

    Audits your installed Claude skills and commands for quality, with a quick mode for recently changed skills and a full mode that evaluates all of them through subagents.

    276k GitHub starsUsed in 5 repos~1.9k tokens
    Auto-check passed
  • Ingests, indexes, searches, edits and monitors video, audio and live streams through the VideoDB Python SDK, returning stream links, clips and timestamps.

    276k GitHub starsUsed in 3 repos~3.5k tokens
    Auto-check: notes
  • Rules Distillation

    affaan-m/ECC

    Scans installed skills for principles that recur across them and proposes rule-file changes: append, revise, add a section, create a file or leave as covered.

    276k GitHub starsUsed in 2 repos~2.3k tokens
    Auto-check passed
  • Builds DRAFT counterparty agreements from one markdown template and a small JSON spec per party, with clauses picked by the party's role.

    276k GitHub stars~2.9k tokensUpdated 4 days ago
    Auto-check passed
  • Measures whether agents actually follow a skill, rule or agent definition by generating scenarios at three strictness levels and scoring tool-call traces.

    276k GitHub starsUsed in 1 repo~623 tokens
    Auto-check passed
  • Instinct-based learning system that observes sessions via hooks, creates atomic instincts with confidence scoring, and evolves them into skills/commands/agents.

    276k GitHub stars~3.5k tokensUpdated 4 days ago
    Auto-check passed

Categories

Questions about Ecc Guide

What does Ecc Guide do?

在回答之前先读取仓库的实时状态,引导用户了解 ECC 当前的 agents、skills、命令、hooks、规则、安装配置档案以及项目接入流程。. Ecc Guide is an agent skill from affaan-m/ECC.

When should I use Ecc Guide?

Ecc Guide fits situations like: agent Workflows work in your project.

How do I install Ecc Guide in Claude Code?

Run `npx skills add affaan-m/ECC --skill ecc-guide -a claude-code`. Or copy the skill folder (docs/zh-CN/skills/ecc-guide in affaan-m/ECC) into .claude/skills/ecc-guide in your project. Claude Code loads it when a task matches its description.

How do I install Ecc Guide in Codex?

Run `npx skills add affaan-m/ECC --skill ecc-guide -a codex`. Or copy the skill folder (docs/zh-CN/skills/ecc-guide in affaan-m/ECC) into .agents/skills/ecc-guide in your project. Codex loads it when a task matches its description.

Can I use Ecc Guide 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 affaan-m/ECC --skill ecc-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ecc-guide, .gemini/skills/ecc-guide, .github/skills/ecc-guide and .opencode/skills/ecc-guide in your project.

What does Ecc Guide need to run?

Going by SKILL.md and its folder, Ecc Guide needs the command-line tools its instructions call (node, npm and rg).

Does Ecc Guide access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Ecc Guide 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 Ecc Guide use?

Ecc Guide 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 Ecc Guide use?

About 837 tokens (SKILL.md is roughly 3.3k 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 Ecc Guide?

Skills that share tags, products or a category with Ecc Guide: MCP Server Builder (anthropics/skills, 180k stars), Hook Development for Claude Code Plugins (anthropics/claude-plugins-official, 38k stars), Using Superpowers (farm-fe/farm, 5.6k stars) and Executing Plans Inline (obra/superpowers, 297k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ecc Guide?

affaan-m (a GitHub user) maintains it in affaan-m/ECC, which has 275,546 GitHub stars. The repository holds 673 skills in this directory. The repository was last updated on October 5, 2026.

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