New to Claude Skills? Learn how to install them →

Aaffaan-m on GitHub

Agent Sort

Free

Streamline your ECC installation based on project needs.

by affaan-m239.3k stars on affaan-m/ecc
3 views
Updated Aug 10, 2026
Get this skill

Free · Opens the source repo

What Agent Sort does

Agent Sort is designed for developers and teams looking to optimize their ECC (Enhanced Command Center) installations by tailoring them to the specific requirements of a project. Instead of relying on a generic full install, this skill employs evidence from the actual codebase to classify and sort ECC components into two distinct categories: DAILY and LIBRARY. This approach ensures that only the most relevant components are loaded, allowing for a cleaner and more efficient development environment.

The skill operates by analyzing the repository's structure and contents, utilizing various evidence sources such as file extensions, package managers, and configuration files. By doing so, it builds a clear picture of the project's stack, identifying which components are essential for daily use and which can be retained for reference without being loaded by default. This classification is not arbitrary; it is backed by concrete evidence from the codebase, ensuring that decisions are data-driven rather than opinion-based.

When using Agent Sort, developers can expect a systematic workflow that includes creating inventories for both DAILY and LIBRARY components, generating an install plan, and producing a verification report to confirm that the installation aligns with the project's actual needs. This skill is particularly useful in scenarios where a project has accumulated unnecessary components over time or when transitioning between different languages or frameworks. By streamlining the ECC installation, teams can focus on what truly matters, enhancing productivity and reducing noise in their development environment.

When to use it

Use this skill when a project requires a focused ECC installation that avoids the overhead of a full bundle.

When not to use it

This skill may not be suitable for projects that require a comprehensive set of ECC components or for teams unfamiliar with their codebase.

What you can build with it

Streamlined Project Setup

When starting a new project, use Agent Sort to create a focused ECC installation that only includes necessary components.

Cleaning Up an Existing Repo

For a repository that has accumulated unnecessary ECC components, run Agent Sort to classify and optimize the installation.

Transitioning Between Frameworks

If your project is shifting to a new language or framework, Agent Sort helps ensure that only relevant ECC components are loaded.

How to install Agent Sort

View source

1. Install with the skills CLI

npx skills add affaan-m/ecc/agent-sort --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by affaan-m

Agent Sort

Use this skill when a repo needs a project-specific ECC surface instead of the default full install.

The goal is not to guess what "feels useful." The goal is to classify ECC components with evidence from the actual codebase.

When to Use

  • A project only needs a subset of ECC and full installs are too noisy
  • The repo stack is clear, but nobody wants to hand-curate skills one by one
  • A team wants a repeatable install decision backed by grep evidence instead of opinion
  • You need to separate always-loaded daily workflow surfaces from searchable library/reference surfaces
  • A repo has drifted into the wrong language, rule, or hook set and needs cleanup

Non-Negotiable Rules

  • Use the current repository as the source of truth, not generic preferences
  • Every DAILY decision must cite concrete repo evidence
  • LIBRARY does not mean "delete"; it means "keep accessible without loading by default"
  • Do not install hooks, rules, or scripts that the current repo cannot use
  • Prefer ECC-native surfaces; do not introduce a second install system

Outputs

Produce these artifacts in order:

  1. DAILY inventory
  2. LIBRARY inventory
  3. install plan
  4. verification report
  5. optional skill-library router if the project wants one

Classification Model

Use two buckets only:

  • DAILY
    • should load every session for this repo
    • strongly matched to the repo's language, framework, workflow, or operator surface
  • LIBRARY
    • useful to retain, but not worth loading by default
    • should remain reachable through search, router skill, or selective manual use

Evidence Sources

Use repo-local evidence before making any classification:

  • file extensions
  • package managers and lockfiles
  • framework configs
  • CI and hook configs
  • build/test scripts
  • imports and dependency manifests
  • repo docs that explicitly describe the stack

Useful commands include:

rg --files
rg -n "typescript|react|next|supabase|django|spring|flutter|swift"
cat package.json
cat pyproject.toml
cat Cargo.toml
cat pubspec.yaml
cat go.mod

Parallel Review Passes

If parallel subagents are available, split the review into these passes:

  1. Agents
    • classify agents/*
  2. Skills
    • classify skills/*
  3. Commands
    • classify commands/*
  4. Rules
    • classify rules/*
  5. Hooks and scripts
    • classify hook surfaces, MCP health checks, helper scripts, and OS compatibility
  6. Extras
    • classify contexts, examples, MCP configs, templates, and guidance docs

If subagents are not available, run the same passes sequentially.

Core Workflow

1. Read the repo

Establish the real stack before classifying anything:

  • languages in use
  • frameworks in use
  • primary package manager
  • test stack
  • lint/format stack
  • deployment/runtime surface
  • operator integrations already present

2. Build the evidence table

For every candidate surface, record:

  • component path
  • component type
  • proposed bucket
  • repo evidence
  • short justification

Use this format:

skills/frontend-patterns | skill | DAILY | 84 .tsx files, next.config.ts present | core frontend stack
skills/django-patterns   | skill | LIBRARY | no .py files, no pyproject.toml       | not active in this repo
rules/typescript/*       | rules | DAILY | package.json + tsconfig.json            | active TS repo
rules/python/*           | rules | LIBRARY | zero Python source files             | keep accessible only

3. Decide DAILY vs LIBRARY

Promote to DAILY when:

  • the repo clearly uses the matching stack
  • the component is general enough to help every session
  • the repo already depends on the corresponding runtime or workflow

Demote to LIBRARY when:

  • the component is off-stack
  • the repo might need it later, but not every day
  • it adds context overhead without immediate relevance

4. Build the install plan

Translate the classification into action:

  • DAILY skills -> install or keep in .claude/skills/
  • DAILY commands -> keep as explicit shims only if still useful
  • DAILY rules -> install only matching language sets
  • DAILY hooks/scripts -> keep only compatible ones
  • LIBRARY surfaces -> keep accessible through search or skill-library

If the repo already uses selective installs, update that plan instead of creating another system.

5. Create the optional library router

If the project wants a searchable library surface, create:

  • .claude/skills/skill-library/SKILL.md

That router should contain:

  • a short explanation of DAILY vs LIBRARY
  • grouped trigger keywords
  • where the library references live

Do not duplicate every skill body inside the router.

6. Verify the result

After the plan is applied, verify:

  • every DAILY file exists where expected
  • stale language rules were not left active
  • incompatible hooks were not installed
  • the resulting install actually matches the repo stack

Return a compact report with:

  • DAILY count
  • LIBRARY count
  • removed stale surfaces
  • open questions

Handoffs

If the next step is interactive installation or repair, hand off to:

  • configure-ecc

If the next step is overlap cleanup or catalog review, hand off to:

  • skill-stocktake

If the next step is broader context trimming, hand off to:

  • strategic-compact

Output Format

Return the result in this order:

STACK
- language/framework/runtime summary

DAILY
- always-loaded items with evidence

LIBRARY
- searchable/reference items with evidence

INSTALL PLAN
- what should be installed, removed, or routed

VERIFICATION
- checks run and remaining gaps

Frequently asked questions about Agent Sort

Similar skills