agent-sort

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:

# ripgrep is not preinstalled anywhere; fall back to find/grep when absent.
if command -v rg >/dev/null; then
  rg --files
  rg -n "typescript|react|next|supabase|django|spring|flutter|swift"
else
  find . -type f -not -path '*/node_modules/*' -not -path '*/.git/*'
  grep -rEn "typescript|react|next|supabase|django|spring|flutter|swift" . \
    --exclude-dir=node_modules --exclude-dir=.git
fi
cat package.json
cat pyproject.toml
cat Cargo.toml
cat pubspec.yaml
cat go.mod