skill-duplication-audit
Audit overlapping skills across A Team and builder packs; identify redundant or conflicting guidance.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 1.6k
- Forks
- 491
01 前言 Front Matter
- name
- skill-duplication-audit
- owner
- Miguel
- score
- 88
- state
- Approved
- target
- a-team
- created
- 1781395200000
- updated
- 1781395200000
- version
- v0.1
- description
- Audit overlapping skills across A Team and builder packs; identify redundant or conflicting guidance.
- compliance-risk
- Low
03 SKILL.md 正文
skill-duplication-audit
Problem
Skills across the 5 ecosystem repositories overlap in scope without documented distinctions. This creates confusion about which skill to invoke, silent redundancy in packs, and conflicting guidance when two skills are active in the same session. Without a structured way to detect and classify overlaps, the ecosystem grows noisier over time.
Objective
Given 2 or more skills with their triggers and objectives, identify pairs that have overlapping scope and classify each pair. Produce a duplication report with a classification and a specific recommendation for each pair.
When to Use
- When adding a new skill and checking whether an existing skill already covers the same use case
- When auditing a pack for internal redundancy
- When comparing skills across packs after an ecosystem audit
- When a user reports confusion about which of two skills to invoke
When NOT to Use
- For a single skill — needs at least 2 skills to compare
- For agents — agents have tool scope and state, not just trigger scope; use a separate analysis
- When the boundary is already documented in an existing boundary doc — verify first
- When the skills are from completely different domains with no plausible trigger overlap
Inputs
| Input | Required | Description |
|---|---|---|
| skill-list | required | 2+ skills, each with: name, trigger (when to use), objective (one sentence), and optionally the repo |
| scope | optional | pack (compare within one repo) or ecosystem (compare across repos). Default: ecosystem |
Outputs
| Output | Description |
|---|---|
| duplication-report | List of pairs with classification and recommendation |
| boundary-docs-needed | List of pairs requiring a documented distinction (partial-overlap pairs only) |
Steps
- Read all inputs. For each skill, extract: name, trigger (what situation invokes it?), objective (what does it produce?).
- Group skills by domain. Only compare skills where triggers could plausibly describe the same situation.
- For each pair within the same domain, compare triggers and outputs:
- Triggers: do they describe the same situation or context?
- Outputs: do they produce the same type of result?
- Classify each pair using exactly one label:
- True duplicate: same trigger AND same output type → recommend merge
- Partial overlap: triggers overlap but differ, OR outputs overlap but differ → recommend document boundary
- Complementary: same domain, different workflow stage, no trigger overlap → keep both, note relationship
- False positive: similar name but different trigger and output → no action required
- For each partial-overlap pair, draft a one-sentence boundary statement: "Use [A] when [condition A]; use [B] when [condition B]."
- List pairs that need a boundary doc (partial-overlap only).
- Fill the Completion Statement.
Completion Statement Format
skill-duplication-audit complete.
Skills analysed: [count]
Pairs evaluated: [count]
True duplicates: [count] — [names or NONE]
Partial overlaps: [count] — [names or NONE]
Complementary pairs: [count] — [names or NONE]
False positives: [count] — [names or NONE]
Boundary docs needed: [count] — [skill pairs or NONE]
Recommendation: [summary action]
Red Flags
- "These two skills have similar names so they must be duplicates" — name similarity is not scope overlap; compare triggers and outputs, not names
- "I'll merge them to reduce complexity" — merging loses scope distinctions; only recommend a merge if triggers AND outputs are genuinely identical
- "The boundary is obvious so it doesn't need documentation" — undocumented boundaries get violated; if there is overlap, document it
- "They're in different repos so they can't conflict" — cross-repo skills are the most common source of undocumented overlap in the ecosystem
- "I'll classify as partial overlap to be safe" — over-classifying creates unnecessary boundary docs; only classify as partial overlap if trigger overlap is real and observable
Examples
Example 1 — True duplicate
Input:
- api-doc-writer: trigger "when writing documentation for a REST API", objective "produce API reference docs"
- api-reference-generator: trigger "when documenting a REST API", objective "generate API reference documentation"
Expected output: True duplicate. Triggers and outputs are semantically identical. Recommend merge. Keep the skill with stronger test coverage.
Example 2 — Complementary
Input:
- prd-quality-gate (builder-product): trigger "when a PRD is drafted and ready for engineering review", objective "gate PRD quality before handoff"
- copy-quality-gate (builder-growth): trigger "when landing page copy is written", objective "gate copy quality before publishing"
Expected output: Complementary. Same quality gate pattern, different domains (product vs. growth), no trigger overlap. No action needed.
Counter-Examples
Counter-Example 1 — False positive mistakenly treated as duplicate
Input:
- design-token-audit (builder-design): trigger "when reviewing design token consistency across components"
- positioning-audit (builder-growth): trigger "when evaluating brand positioning and messaging clarity"
What should happen: False positive. "Audit" in the name is irrelevant — triggers are in completely different domains. No action.
What the skill must NOT do: Recommend a merge or boundary doc based on shared vocabulary alone.
Counter-Example 2 — Complementary pair forced into partial-overlap
Input:
- eval-before-ship (builder-ai): trigger "before deploying an LLM model or prompt to production"
- prd-quality-gate (builder-product): trigger "when a PRD is drafted and ready for engineering review"
What should happen: Complementary — different stages of the product lifecycle, no trigger overlap.
What the skill must NOT do: Classify these as partial-overlap because both are "gates" in an AI product workflow.
Test Cases
| ID | File | Description | Pass |
|---|---|---|---|
| TC-001 | test-cases/case-001-true-duplicate.md | True duplicate: identical trigger and output type | ✅ |
| TC-002 | test-cases/case-002-complementary-quality-gates.md | Complementary: prd-quality-gate vs copy-quality-gate | ✅ |
| TC-003 | test-cases/case-003-partial-overlap-ai-reviewers.md | Partial overlap: ai-reviewer vs ai-safety-reviewer | ✅ |
| TC-004 | test-cases/case-004-false-positive-audit-name.md | False positive: same word in name, different domain | ✅ |
| TC-005 | test-cases/case-005-ecosystem-experiment-ab-test.md | Ecosystem: experiment-design vs ab-test-design | ✅ |
| TC-006 | test-cases/case-006-ecosystem-ai-feature-safety.md | Ecosystem: ai-feature-validation vs ai-safety-review | ✅ |
| TC-007 | test-cases/case-007-ecosystem-messaging-safety.md | Ecosystem: ai-messaging-review vs ai-safety-review | ✅ |
| TC-008 | test-cases/case-008-no-duplicates.md | No duplicates: 3 skills in different domains | ✅ |
| TC-009 | test-cases/case-009-large-list.md | Large list: 5 skills, 1 true duplicate, 1 partial overlap | ✅ |
| TC-010 | test-cases/case-010-low-context.md | Low context: skill names only, no triggers provided | ✅ |
Evaluation History
| Version | Date | Score | Recommendation | Report |
|---|---|---|---|---|
| v0.1 | 2026-06-14 | 88 | Approved — promotion proposal pending | evaluations/skills/skill-duplication-audit/eval-001.md |
04 同仓库更多 Skills
worktable-review-with-annotations
Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.
worktable-find-and-synthesize-context
Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.
worktable-create-or-update-docs
Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.
worktable-create-or-manage-records
Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.
worktable-create-or-manage-interactive-html
Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.
worktable-collaborate-threads
Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.