convez.ai
SkillAutomaçãoIntermediário
kllin8154-arch

Agent Skill Router

kllin8154-arch/agent-skill-router

Roteamento inteligente e governança de skills para agentes de código

Ver no GitHub
BomPluginScore · de 0 a 100

Template de roteamento e governança local de skills para Claude Code, Codex e outros agentes de IA. Resolve problemas de duplicação de skills, descoberta automática, consistência de regras e revisão segura de skills externos, com suporte bilíngue (EN/ZH).

Instalação

$npx convez-ai kllin8154-arch/agent-skill-router

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
0
Acompanhando
0
Saúde
71%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Organizar e indexar múltiplos skills em workflows com IA
  • Implementar governança e deduplicação de skills em equipes
  • Padronizar regras de baseline para Claude Code e Codex
  • Revisar e integrar skills externos com segurança

Veredito

Template prático e bem estruturado para quem gerencia múltiplos skills com agentes de IA. Reduz duplicação e traz consistência, mas exige configuração inicial e manutenção manual do índice de skills.

README

A tradução para o português deste README ainda está na fila.


Why This Project Exists

Many AI coding workflows eventually face the same problems:

  • Agents do not proactively find the right Skill.
  • New sessions forget role-specific rules.
  • Skills become duplicated, overlapping, or hard to maintain.
  • Coding agents lack a consistent engineering baseline.
  • New Skills are added without updating an index or manual.
  • Agents may blindly copy external Skills from GitHub.
  • Claude Code and Codex rules are difficult to keep consistent.

This project provides a reusable bilingual template system for both international and Chinese users.


English vs Chinese Templates

This repository provides two template sets:

templates/en
templates/zh

English Templates

The English templates are designed for international users.

They do not force any specific response language.

Agents should respond in the user's language by default.

Chinese Templates

The Chinese templates are designed for Chinese users and Chinese development teams.

They default to Chinese responses and include Chinese documentation conventions.


Recommended Structure

agent-skill-router/
├── README.md
├── README-ZH.md
├── LICENSE
├── .gitignore
├── templates/
│   ├── en/
│   │   ├── claude/
│   │   │   └── CLAUDE.md
│   │   ├── codex/
│   │   │   └── AGENTS.md
│   │   └── shared/
│   │       ├── skill-index.json
│   │       ├── Skill-Quick-Reference-EN.md
│   │       ├── skill-governance/
│   │       │   └── SKILL.md
│   │       └── skill-template/
│   │           └── SKILL.md
│   └── zh/
│       ├── claude/
│       │   └── CLAUDE.md
│       ├── codex/
│       │   └── AGENTS.md
│       └── shared/
│           ├── skill-index.json
│           ├── 技能速查手册-ZH.md
│           ├── skill-governance/
│           │   └── SKILL.md
│           └── skill-template/
│               └── SKILL.md
├── scripts/
└── docs/

Core Files

FilePurpose
CLAUDE.mdGlobal rules for Claude Code
AGENTS.mdGlobal rules for Codex
skill-index.jsonMachine-readable Skill routing index
Skill-Quick-Reference-EN.mdEnglish human-readable Skill manual
技能速查手册-ZH.mdChinese human-readable Skill manual
skill-governance/SKILL.mdSkill creation, merging, deduplication, and external review rules
skill-template/SKILL.mdStandard template for new Skills

Skill Name Parameters

This project uses parameters instead of hard-coded Skill names.

You can keep the default names or replace them with your own Skill names.

ParameterDefault Suggested SkillPurpose
{{PROGRAMMING_BASELINE_SKILL}}karpathy-guidelinesMandatory baseline for programming tasks
{{SKILL_GOVERNANCE_SKILL}}skill-governanceSkill creation, merging, deduplication, and external Skill review
{{DESIGN_SYSTEM_SKILL}}design-systemUI design systems, visual consistency, component guidelines
{{FRONTEND_PATTERNS_SKILL}}frontend-patternsFrontend architecture, component patterns, UI implementation
{{BROWSER_QA_SKILL}}browser-qaBrowser-based UI validation and visual QA
{{E2E_TESTING_SKILL}}e2e-testingEnd-to-end testing workflows
{{TDD_WORKFLOW_SKILL}}tdd-workflowTest-driven development workflow
{{VERIFICATION_LOOP_SKILL}}verification-loopBuild, test, and verification loops
{{SECURITY_REVIEW_SKILL}}security-reviewSecurity review and risk analysis
{{SAFETY_GUARD_SKILL}}safety-guardHigh-risk operation protection
{{API_DESIGN_SKILL}}api-designAPI design and REST conventions
{{DATABASE_MIGRATIONS_SKILL}}database-migrationsDatabase schema changes and migration planning
{{POSTGRES_PATTERNS_SKILL}}postgres-patternsPostgreSQL and compatible database patterns
{{DEPLOYMENT_PATTERNS_SKILL}}deployment-patternsDeployment, rollback, health checks, production readiness
{{DOCKER_PATTERNS_SKILL}}docker-patternsDocker and Docker Compose patterns
{{BLUEPRINT_SKILL}}blueprintPlanning and task breakdown
{{ARCHITECTURE_DECISION_RECORDS_SKILL}}architecture-decision-recordsArchitecture decision records
{{HEXAGONAL_ARCHITECTURE_SKILL}}hexagonal-architectureHexagonal architecture and ports/adapters
{{AGENTIC_ENGINEERING_SKILL}}agentic-engineeringAI Agent engineering workflow
{{EVAL_HARNESS_SKILL}}eval-harnessEvaluation-driven development for agents

How It Works

1. Skill Routing

Before handling a complex task, the agent should:

  1. Check skill-index.json.
  2. If needed, check the human-readable Skill manual.
  3. Identify the task type, role, tech stack, keywords, and expected output.
  4. Load only the 1 to 3 most relevant Skills.
  5. Avoid loading all Skills at once.

2. Mandatory Programming Baseline

For programming-related work, the agent must use:

{{PROGRAMMING_BASELINE_SKILL}}

This applies to:

  • Writing code / modifying code / refactoring / bug fixing
  • Code review / API design / database design
  • Test writing / architecture design / technical planning
  • Frontend / backend / DevOps automation / AI Agent development

Default combination:

{{PROGRAMMING_BASELINE_SKILL}} + domain Skill + verification or security Skill

3. Skill Governance

Before creating a new Skill, the agent must check whether a similar Skill already exists.

If an existing Skill covers most of the workflow, do not create a new Skill.

If the new requirement is only a branch scenario, update the existing Skill instead.

A new Skill should only be created when:

  • Existing Skills cannot cover the core workflow.
  • It is not a small branch of an existing Skill.
  • It is not just a renamed concept.
  • It is likely to be reused.
  • It has clear triggers, inputs, outputs, workflow, and avoid conditions.

4. External Skill Review

GitHub or external search should only be used when no suitable local Skill exists.

Do not directly install or copy external Skills without review.

Before adopting an external Skill, check whether it:

  • Contains destructive commands.
  • Reads secrets, tokens, cookies, SSH keys, or .env files.
  • Uploads local files.
  • Executes remote scripts.
  • Contains obfuscated code.
  • Depends on unknown MCP services.
  • Bypasses user confirmation for high-risk actions.

After review, extract useful ideas and rewrite them as a local Skill draft.


Installation

Installation scripts can be found under scripts/:

  • install-codex-en.ps1 — Install English templates for Codex
  • install-codex-zh.ps1 — Install Chinese templates for Codex

To install:

# For Codex English templates
.\scripts\install-codex-en.ps1

# For Codex Chinese templates
.\scripts\install-codex-zh.ps1

Security Notice

Do not commit:

  • API keys / Tokens / Cookies / SSH keys
  • .env files / Database connection strings
  • Internal IP addresses / Production configuration
  • Private project configuration / Company internal documents
  • User personal information

This repository should contain templates, rules, sanitized examples, and installation scripts only.


License

MIT License

Ver o original no GitHub

Bom para

Relacionados