Communitygithub.com

agent-sort

특정 저장소에 대한 증거 기반 ECC 설치 계획을 수립하는 스킬입니다. 병렬 저장소 인식 리뷰 패스를 사용하여 스킬, 명령어, 규칙, 훅, 추가 항목을 DAILY와 LIBRARY 버킷으로 분류합니다. ECC를 전체 번들 대신 프로젝트에 실제로 필요한 항목만 설치하도록 정리할 때 사용하세요.

agent-sort란 무엇인가요?

이 스킬은 AI 에이전트가 특정 저장소에 대해 ECC(Enhanced Codebase Configuration) 설치 범위를 최적화할 수 있도록 설계되었습니다. 기본 전체 설치 방식 대신, 실제 코드베이스 증거를 기반으로 ECC 구성 요소를 DAILY(매일 로드)와 LIBRARY(검색 가능한 참고용) 두 가지 버킷으로 분류합니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용 가능하며, 병렬 서브 에이전트를 활용하여 스킬, 명령어, 규칙, 훅, 추가 항목을 동시에 리뷰할 수 있습니다. 최종적으로 설치 계획, 검증 보고서, 그리고 선택적으로 `skill-library` 라우터를 생성하여 반복 가능한 증거 기반 설치 결정을 지원하며, 저장소가 잘못된 언어 규칙이나 훅으로 오염된 경우 정리 작업에도 유용합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/ECC/tree/main/skills/agent-sort

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Agent Sort

이 저장소에 기본 전체 설치 대신 프로젝트별 ECC 범위가 필요할 때 이 스킬을 사용하세요.

목표는 "유용해 보이는" 것을 추측하는 것이 아닙니다. 목표는 실제 코드베이스의 증거를 바탕으로 ECC 구성 요소를 분류하는 것입니다.

사용 시기

  • 프로젝트에 ECC의 일부만 필요하고 전체 설치는 너무 복잡할 때
  • 저장소 스택이 명확하지만, 누구도 스킬 하나하나를 수동으로 선별하고 싶지 않을 때
  • 팀이 의견이 아닌 grep 증거로 뒷받침되는 반복 가능한 설치 결정을 원할 때
  • 항상 로드되는 일상 워크플로우 영역과 검색 가능한 라이브러리/참고 영역을 분리해야 할 때
  • 저장소가 잘못된 언어, 규칙 또는 훅 세트로 오염되어 정리가 필요할 때

필수 규칙

  • 일반적인 선호도가 아닌 현재 저장소를 진실의 원천으로 사용하세요.
  • 모든 DAILY 결정은 구체적인 저장소 증거를 인용해야 합니다.
  • LIBRARY는 "삭제"를 의미하지 않습니다. "기본 로드 없이 접근 가능하게 유지"를 의미합니다.
  • 현재 저장소가 사용할 수 없는 훅, 규칙 또는 스크립트를 설치하지 마세요.
  • ECC 네이티브 영역을 선호하세요. 두 번째 설치 시스템을 도입하지 마세요.

결과물

다음 아티팩트를 순서대로 생성하세요:

  1. DAILY 인벤토리
  2. LIBRARY 인벤토리
  3. 설치 계획
  4. 검증 보고서
  5. 프로젝트가 원하는 경우 선택적 skill-library 라우터

분류 모델

두 개의 버킷만 사용하세요:

  • DAILY
    • 이 저장소의 모든 세션에서 로드되어야 함
    • 저장소의 언어, 프레임워크, 워크플로우 또는 운영자 영역과 강하게 일치함
  • LIBRARY
    • 유지하는 것이 유용하지만 기본 로드할 가치는 없음
    • 검색, 라우터 스킬 또는 선택적 수동 사용을 통해 접근 가능해야 함

증거 소스

분류를 하기 전에 저장소 로컬 증거를 사용하세요:

  • 파일 확장자
  • 패키지 매니저 및 잠금 파일
  • 프레임워크 설정
  • CI 및 훅 설정
  • 빌드/테스트 스크립트
  • 임포트 및 의존성 매니페스트
  • 스택을 명시적으로 설명하는 저장소 문서

유용한 명령어:

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

병렬 리뷰 패스

병렬 서브 에이전트를 사용할 수 있는 경우 리뷰를 다음 패스로 나누세요:

  1. 에이전트
    • agents/* 분류
  2. 스킬
    • skills/* 분류
  3. 명령어
    • commands/* 분류
  4. 규칙
    • rules/* 분류
  5. 훅 및 스크립트
    • 훅 영역, MCP 상태 확인, 도우미 스크립트 및 OS 호환성 분류
  6. 추가 항목
    • 컨텍스트, 예제, MCP 설정, 템플릿 및 가이드 문서 분류

서브 에이전트를 사용할 수 없는 경우 동일한 패스를 순차적으로 실행하세요.

핵심 워크플로우

1. 저장소 읽기

분류하기 전에 실제 스택을 파악하세요:

  • 사용 중인 언어
  • 사용 중인 프레임워크
  • 기본 패키지 매니저
  • 테스트 스택
  • 린트/포맷 스택
  • 배포/런타임 영역
  • 이미 존재하는 운영자 통합

2. 증거 테이블 구축

모든 후보 영역에 대해 다음을 기록하세요:

  • 구성 요소 경로
  • 구성 요소 유형
  • 제안된 버킷
  • 저장소 증거
  • 간단한 근거

다음 형식을 사용하세요:

skills/frontend-patterns | skill | DAILY | .tsx 파일 84개, next.config.ts 존재 | 핵심 프론트엔드 스택
skills/django-patterns   | skill | LIBRARY | .py 파일 없음, pyproject.toml 없음       | 이 저장소에서 활성화되지 않음
rules/typescript/*       | rules | DAILY | package.json + tsconfig.json            | 활성 TS 저장소
rules/python/*           | rules | LIBRARY | Python 소스 파일 0개             | 접근만 가능하게 유지

3. DAILY vs LIBRARY 결정

다음 경우 DAILY로 승격:

  • 저장소가 일치하는 스택을 명확히 사용함
  • 구성 요소가 모든 세션에 도움이 될 만큼 일반적임
  • 저장소가 이미 해당 런타임 또는 워크플로우에 의존함

다음 경우 LIBRARY로 강등:

  • 구성 요소가 스택에서 벗어남
  • 저장소가 나중에 필요할 수 있지만 매일은 아님
  • 즉각적인 관련성 없이 컨텍스트 오버헤드를 추가함

4. 설치 계획 구축

분류를 실행으로 변환:

  • DAILY 스킬 -> .claude/skills/에 설치 또는 유지
  • DAILY 명령어 -> 여전히 유용한 경우에만 명시적 shim으로 유지
  • DAILY 규칙 -> 일치하는 언어 세트만 설치
  • DAILY 훅/스크립트 -> 호환 가능한 것만 유지
  • LIBRARY 영역 -> 검색 또는 skill-library를 통해 접근 가능하게 유지

저장소가 이미 선택적 설치를 사용하는 경우 다른 시스템을 만들지 말고 해당 계획을 업데이트하세요.

5. 선택적 라이브러리 라우터 생성

프로젝트가 검색 가능한 라이브러리 영역을 원하는 경우 생성:

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

해당 라우터에는 다음이 포함되어야 함:

  • DAILY vs LIBRARY에 대한 간단한 설명
  • 그룹화된 트리거 키워드
  • 라이브러리 참조 위치

라우터 내에 모든 스킬 본문을 복제하지 마세요.

6. 결과 검증

계획이 적용된 후 검증:

  • 모든 DAILY 파일이 예상 위치에 존재함
  • 오래된 언어 규칙이 활성 상태로 남아 있지 않음
  • 호환되지 않는 훅이 설치되지 않음
  • 결과 설치가 실제로 저장소 스택과 일치함

다음이 포함된 간결한 보고서 반환:

  • DAILY 개수
  • LIBRARY 개수
  • 제거된 오래된 영역
  • 열린 질문

핸드오프

다음 단계가 대화형 설치 또는 수리인 경우 핸드오프:

  • configure-ecc

다음 단계가 중복 정리 또는 카탈로그 리뷰인 경우 핸드오프:

  • skill-stocktake

다음 단계가 더 넓은 컨텍스트 정리인 경우 핸드오프:

  • strategic-compact

출력 형식

결과를 다음 순서로 반환:

STACK
- 언어/프레임워크/런타임 요약

DAILY
- 증거가 있는 항상 로드되는 항목

LIBRARY
- 증거가 있는 검색 가능/참고 항목

INSTALL PLAN
- 설치, 제거 또는 라우팅해야 할 항목

VERIFICATION
- 실행된 검사 및 남은 격차

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/content-engine

Create platform-native content systems for X, LinkedIn, TikTok, YouTube, newsletters, and repurposed multi-platform campaigns. Use when the user wants social posts, threads, scripts, content calendars, or one source asset adapted cleanly across platforms.

affaan-m/ECC

Multi-platform content distribution across X, LinkedIn, Threads, and Bluesky. Adapts content per platform using content-engine patterns. Never posts identical content cross-platform. Use when the user wants to distribute content across social platforms.

affaan-m/fal-ai-media

Unified media generation via fal.ai MCP — image, video, and audio. Covers text-to-image (Nano Banana), text/image-to-video (Seedance, Kling, Veo 3), text-to-speech (CSM-1B), and video-to-audio (ThinkSound). Use when the user wants to generate images, videos, or audio with AI.

affaan-m/manim-video

日本語翻訳:このファイルは manim-video 用の日本語翻訳が必要です

affaan-m/remotion-video-creation

Remotion のベストプラクティス - React で動画を作成する。3D、アニメーション、音声、字幕、チャート、トランジションなどをカバーするドメイン固有の29のルール。

affaan-m/video-editing

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

agent-self-evaluation

Use after completing any non-trivial task. The agent self-rates its output on 5 axes — accuracy, completeness, clarity, actionability, conciseness — with concrete evidence per criterion. Produces a structured 1-5 scorecard with specific improvement suggestions.

ai-first-engineering

Engineering operating model for teams where AI agents generate a large share of implementation output. Use when setting team process, review gates, or ownership rules for a codebase largely written by agents.

ai-regression-testing

Regression testing strategies for AI-assisted development. Sandbox-mode API testing without database dependencies, automated bug-check workflows, and patterns to catch AI blind spots where the same model writes and reviews code. Use when adding regression coverage to AI-assisted code, or when the same model both wrote and reviewed a change.

android-clean-architecture

Clean Architecture patterns for Android and Kotlin Multiplatform projects — module structure, dependency rules, UseCases, Repositories, and data layer patterns. Use when structuring modules, layers, or data flow in an Android or KMP project.

angular-developer

Generates Angular code and provides architectural guidance. Trigger when creating projects, components, or services, or for best practices on reactivity (signals, linkedSignal, resource), forms, dependency injection, routing, SSR, accessibility (ARIA), animations, styling (component styles, Tailwind CSS), testing, or CLI tooling.

api-connector-builder

Build a new API connector or provider by matching the target repo

관련 스킬