Communitygithub.com

YepAPI/skills

Patrones de uso de herramientas, razonamiento multi-paso, orquestación de agentes y salidas estructuradas.

¿Qué es skills?

Esta skill define las reglas, patrones y anti-patrones para construir agentes de IA confiables que utilizan herramientas, razonamiento multi-paso y salidas estructuradas. Es útil para cualquier desarrollador que trabaje con marcos de agentes como Vercel AI SDK, LangChain o frameworks similares. La skill enfatiza la definición de funciones tipadas como herramientas, ciclos de ejecución multi-paso con un límite de `maxSteps` para evitar bucles infinitos, validación de salidas con Zod y lógica de reintentos con backoff exponencial. Además, promueve la orquestación de agentes: dividir tareas complejas en sub-agentes especializados y emplear un agente coordinador que delegue, en lugar de construir agentes monolíticos con demasiadas herramientas. Incluye ejemplos concretos de código TypeScript usando `tool()` y `generateText()`, y advierte sobre malas prácticas como otorgar acceso irrestricto a herramientas, confiar en salidas sin validar y olvidar establecer el límite de pasos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YepAPI/skills/tree/HEAD/skills/ai-agents

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Agentes de IA

Reglas

  • Define herramientas como funciones tipadas con descripciones — el modelo elige qué herramienta invocar
  • Esquema de herramienta: { name, description, parameters: zodSchema, execute: async (args) => result }
  • Bucle multi-paso: enviar mensajes → el modelo devuelve una llamada a herramienta → ejecutar herramienta → retroalimentar el resultado → repetir hasta terminar
  • Límite maxSteps para evitar bucles infinitos — por defecto 5-10 pasos dependiendo de la complejidad
  • Salidas estructuradas con Zod: generateObject({ schema: z.object({...}) }) para una forma garantizada
  • Lógica de reintentos: envolver la ejecución de herramientas en try/catch, reintentar fallos transitorios 2-3 veces con backoff exponencial
  • Orquestación de agentes: dividir tareas complejas en sub-agentes con conjuntos de herramientas enfocados, un agente coordinador delega
  • Siempre valida los resultados de las herramientas antes de retroalimentarlos al modelo — sanitiza datos no confiables
  • Usa streamText con onToolCall para visibilidad en tiempo real del razonamiento del agente

Patrones

// Definición de herramienta
const tools = {
  searchDatabase: tool({
    description: "Buscar en la base de datos de productos",
    parameters: z.object({ query: z.string(), limit: z.number().default(10) }),
    execute: async ({ query, limit }) => db.products.search(query, limit),
  }),
};

// Bucle del agente
const result = await generateText({
  model,
  tools,
  maxSteps: 10,
  messages,
});

Evitar

  • Dar acceso irrestricto a herramientas a los agentes — limita las herramientas a la tarea
  • Olvidar maxSteps — los agentes pueden ciclar para siempre
  • Confiar en las salidas de las herramientas sin validación — siempre verifica antes de actuar sobre los resultados
  • Agentes monolíticos — prefiere sub-agentes enfocados en lugar de un agente con más de 20 herramientas

Individual skills in this repo

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

YepAPI/skills

WCAG 2.1 AA — semantic HTML, keyboard navigation, screen readers.

YepAPI/skills

Experiment setup, variant splitting, statistical significance, and feature flag integration.

YepAPI/skills

CRUD generators, data tables, user management, role-based access, and bulk operations.

YepAPI/skills

Monitor what ChatGPT and Gemini say about your brand using YepAPI.

YepAPI/skills

Queue workers with BullMQ/Inngest/Trigger.dev, job retries, dead letter queues, concurrency.

YepAPI/skills

Commander.js, interactive prompts with Clack, spinners, colors, config files, exit codes, and npm publishing.

YepAPI/skills

cmdk integration, Cmd+K trigger, fuzzy search, grouped actions, keyboard navigation, and dynamic action registration.

YepAPI/skills

Content planning with trend and sentiment data from YepAPI.

YepAPI/skills

Content calendar, keyword-driven planning, and content briefs.

YepAPI/skills

Theme switching with CSS variables, system preference detection, next-themes, and persistence.

YepAPI/skills

Threaded comments, @mentions, reactions, moderation queue, optimistic UI, and cursor pagination.

YepAPI/skills

Competitive analysis between domains using YepAPI.

YepAPI/skills

Layout grids, KPI cards, data tables with sorting/filtering, sidebar navigation, and responsive breakpoints.

YepAPI/skills

Data encryption — TLS everywhere, AES-256-GCM for PII, bcrypt passwords, encrypted backups.

YepAPI/skills

Chart patterns with Recharts/Nivo/D3, responsive containers, color scales, and accessibility.

YepAPI/skills

Drizzle schema definition, push vs migrate, type-safe queries, relations, transactions, and prepared statements.

YepAPI/skills

Upload handling, resize/compress, CDN delivery, blur placeholders, and next/image patterns.

YepAPI/skills

Local business and Google Maps research using YepAPI.

YepAPI/skills

Cursor-based pagination, IntersectionObserver, virtualized lists with @tanstack/react-virtual, and scroll position restoration.

YepAPI/skills

Chat UI components, streaming responses with AI SDK, context window management, and RAG patterns.

Skills relacionados