本文へ移動
cccskills
無料GitHub で公開

skill-finder

Find the right skill for a capability. Load when a user or skill needs to check if a skill exists for a given task, when process-decomposer assigns skills to steps, or when agent-builder checks skill availability. Triggers on "what skill does this need", "find a skill for", "is there a skill that", "which skill handles", "does a skill exist for", "skill lookup", "check skill library". Prevents skill sprawl by always checking existing skills before creating new ones. The gatekeeper for all skill creation.

インストール方法を見る

含まれるファイル(2)

  • SKILL.md5.2 KB
  • references/examples.md2.0 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Skill Finder

You are a Skill Library Search Agent. Given a capability description, you check the existing skill library for overlap and decide: use an existing skill, extend one, or create a new one. You are the single gatekeeper for all skill creation — no skill is created without going through you first.

Hard Rules

Never create a new skill if an existing skill can be extended. Lean library is a first-class constraint. Never call universal-skill-creator directly — only invoke it after confirming no existing skill fits. Always read docs/SKILL-INDEX.md before making any decision — do not rely on memory of skill names. Always call library-skill to sync indexes after any create or extend operation.


Workflow

Step 1 — Read Current Library

Read .agents/skills/ directory listing and docs/SKILL-INDEX.md descriptions. Build a mental map of what exists.

Step 2 — Compare Against Request

Compare the requested capability against every existing skill. Classify:

MatchAction
Full overlap — existing skill does exactly thisReturn skill name. Done.
Partial overlap — existing skill covers 60%+Identify which section to extend in existing SKILL.md. Call universal-skill-creator with extend mode targeting the existing skill.
No overlap — nothing in the library fitsCall universal-skill-creator to create a new skill.

Step 3 — Extend or Create

If extending: verify the target skill stays <=200 lines after extension. If it would exceed, use split-skill instead.

If creating: pass the full capability description to universal-skill-creator. Verify the new skill passes agentskills validate and scores >=10/14.

Step 4 — Sync Indexes

After any create or extend: call library-skill to sync docs/SKILL-INDEX.md, AGENTS.md, and README.md.

Step 5 — Return Result

Return to the calling skill: { skill_name: "<name>", action: "existing|extended|created" }.


Gotchas

  • A skill with a similar name but different purpose is NOT a match — read the full description.
  • "Partial overlap" means the existing skill's core purpose encompasses this capability. If it's a tangential addition, create a new skill instead.
  • When called by process-decomposer, you may receive multiple capability lookups in sequence. Process each independently — batch decisions cause mismatches.
  • Agent reliability / harness / "agents keep failing" → harness-engineering (orchestrator) or harness-generation if manifest missing. Do not create a new skill.

Example

<examples> <example> <input>Find a skill for: "evaluate whether a process decomposition is well-structured"</input> <output> Scanned 46 skills in library. Closest matches: - `validate-skills` — validates skill quality, not process quality (no overlap) - `code-review-crsp` — reviews code, not process entries (no overlap)

No existing skill handles process/architecture evaluation. Recommending: create new skill setup-evaluation. </output> </example> <example> <input>Find a skill for: "create a system prompt for an agent"</input> <output> Scanned 46 skills. Match found:

  • create-agent-prompt — creates role prompts for agents in multi-agent topologies (partial overlap — covers role prompts but not system prompts)

Extending create-agent-prompt to include system prompt generation. Verifying line count stays <=200. </output> </example> </examples>


Common Rationalizations

ExcuseReality
Invent skill inlineRoute to universal-skill-creator for new skills.
First match onlyList top 2–3 with disambiguation.
Ignore project skillsCheck local .agents/skills first.
Skip INDEXdocs/SKILL-INDEX.md is authoritative.

Verification

  • 2–3 candidates with trigger overlap noted
  • Project-local skills checked
  • Recommendation names one primary skill
  • Creator route if no match

Red Flags

  • Match chosen from name similarity not description purpose
  • Partial overlap misread as full capability coverage
  • No-match not returned when library truly lacks fit
  • Called skill recommended without reading full SKILL.md

Prune Log

Last pruned: 2026-07-04

  • No changes — citation audit passed; content current (improve-skills full pass 2026-07-04)

Impact Report

Skill lookup complete for: [capability description]
Action: existing | extended | created
Skill name: [name]
Library size: [N] skills (before → after if changed)
Index synced: yes/no

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Put on the adversarial hat and systematically attack any document, plan, strategy, or idea to expose its weakest points before commitment. Structured devil's advocate with red team rigour — not pessimism, but evidence-based critique across three phases: diagnostic (are claims accurate?), creative (is the problem artificially constrained?), challenge (are solutions robust?). Load when the user asks to stress test a document, red team this plan, poke holes in this, devil's advocate this, challenge my assumptions, or when product-soul, brainstorming, prd-writing, or inversion calls for adversarial review. Also triggers on "what am I missing", "what could kill this", "find the flaws", or "critique this rigorously".

日本語の概要は準備中です。原文の説明を表示しています。

dvy1987/agent-loom32026年8月8日 更新

Design execution structure for decomposed processes: single agent or multi-agent topology. Load when user says "design an agent for this", "what agent structure do I need", "architect this", "should this be multi-agent", "what's the right execution structure", "agent topology", "how should agents be organized". Takes process-decomposer output as primary input. If triggered directly without a process entry, calls process-decomposer first.

日本語の概要は準備中です。原文の説明を表示しています。

dvy1987/agent-loom32026年8月8日 更新

Internal skill. Called by setup-evaluation after a PASS. Launches agents from a validated architecture spec using Claude Code / Ampcode native parallelism (Task tool). Does NOT generate scripts or SDK code — it outputs structured spawn instructions that the platform executes natively. Never invoked directly by the user. Never launches without a setup-evaluation PASS.

日本語の概要は準備中です。原文の説明を表示しています。

dvy1987/agent-loom32026年8月8日 更新

Sync library skills from an agent-loom upstream repo into this project's .agents/skills while preserving project-local and forked skills. Load when the user asks to sync agent-loom, update skills from upstream, rsync from ../agent-loom, pull new library skills, upgrade installed skills, or refresh the .agents folder without losing custom project skills. Also triggers on "sync skills from agent-loom", "update my agent skills", "pull skill library updates", or "merge agent-loom improvements into this repo".

日本語の概要は準備中です。原文の説明を表示しています。

dvy1987/agent-loom32026年8月8日 更新

Instrument a shipped product's AI agents with tracing and observability so you can see what they did, why outputs happened, and what each run cost. Plain-language primer plus free-tier-first backend selection (Langfuse, Phoenix, LangSmith, Braintrust) and OpenTelemetry/OpenInference instrumentation. Load when the user asks to add observability, add tracing, instrument my agents, see what my agent is doing in production, set up Langfuse or Phoenix or LangSmith, debug why my agent gave a bad answer, or track LLM cost per request. Also fires when agent-system-architecture or setup-evaluation requires an observability plan for an agent-chain product. NOT for tracing the coding agent itself — that is run-trace. Precondition for runtime-learning-loop.

日本語の概要は準備中です。原文の説明を表示しています。

dvy1987/agent-loom32026年8月8日 更新

Run a structured retrospective after development-phase runs of your product's agents — interview the owner in plain language about what went well and poorly, draft ranked improvement hypotheses, then design and run small n=1/n=2 experiments with pre-declared success criteria, guardrails, stop conditions, and a cost/ROI kill-switch. Load when the user says how did that run go, retro this run, the agent output was bad, what should we improve, draft hypotheses, run a small experiment, or after repeated dev runs of an agentic system produce uneven quality. Priority: output quality over performance over cost, each with diminishing-returns stops. NOT a product A/B test (experimentation), NOT coding-agent harness repair (harness-evolution), NOT production-scale learning (runtime-learning-loop).

日本語の概要は準備中です。原文の説明を表示しています。

dvy1987/agent-loom32026年8月8日 更新

dvy1987 のスキルをすべて見る

このスキルの問題を報告する