CommunityRedacción y edicióngithub.com

Al0olo/Agents-village

Redacta o edita documentación, READMEs, descripciones de PR e investigaciones en prosa siguiendo el estilo de este repositorio. Úsalo cada vez que produzcas prosa dirigida a lectores.

¿Qué es Agents-village?

Esta habilidad permite a los agentes de IA (como Claude Code, Cursor o Codex) redactar o editar documentación técnica, READMEs, descripciones de pull requests e investigaciones en prosa manteniendo el estilo consistente del repositorio. Es especialmente útil cuando se crea contenido dirigido a lectores humanos, ya que impone reglas claras para mejorar la claridad, concisión y legibilidad. Funciona en cualquier plataforma que lea archivos SKILL.md y se basa en pautas como: encabezar con la idea principal, usar una idea por párrafo, preferir ejemplos concretos (números, archivos, comandos) sobre abstracciones, evitar narraciones de procesos o autoreferencias, eliminar relleno innecesario (como “es importante señalar” o “robusto”), y mantener una estructura simple con tablas solo para comparaciones y listas para pasos o elementos paralelos. También especifica cómo organizar README.md (qué es, para personas) y AGENTS.md (reglas para agentes), y cómo manejar fechas y estado operativo en archivos dedicados. Al leer el texto como si fuera un extraño, se fomenta cortar cualquier cosa que este saltaría.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Al0olo/Agents-village/tree/HEAD/.claude/skills/docs-style

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Ver original→Ver todas las habilidades

Preguntar en tu IA favorita

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

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Documentación

Estilo de documentación

  • Encabeza con la idea principal. Una idea por párrafo. Oraciones cortas.
  • Concreto sobre general: un número, un archivo, un comando, un nombre.
  • Sin narración de procesos ni autoreferencias en documentos dirigidos al lector.
  • Sin relleno: elimina "es importante señalar", "con el fin de", "robusto", "aprovechar", "completo", "sin fisuras".
  • Tablas solo para comparaciones; listas solo para pasos o elementos paralelos.
  • Indica la incertidumbre una vez, donde corresponda, y di qué la resolvería.
  • Cada directorio tiene un README.md (qué es, para personas) y un AGENTS.md (reglas que un agente puede aplicar). Actualiza ambos cuando el propósito del directorio o sus reglas cambien.
  • Los documentos dirigidos al lector llevan una línea de autoría y, como máximo, una fecha. El estado operativo va en docs/HANDOFF.md y docs/handoff/LOG.md.
  • Lee el texto como si fueras un extraño. Elimina todo lo que ese extraño saltaría.

Individual skills in this repo

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

Al0olo/Agents-village

Design, pre-register, run or analyze an experiment (RQ1, RQ2, RQ3). Use when writing a pre-registration, choosing arms, measures, sample size or statistics, planting facts, or interpreting results.

Al0olo/Agents-village

Branch, commit and open pull requests in this repo. Use whenever creating a branch, writing a commit message, pushing, opening or updating a PR, or when CI fails on a PR.

Al0olo/Agents-village

Read the previous agent's state at the start of a session and write yours at the end. Use at the start and end of every session, after any milestone, decision, failure or environment discovery, and whenever the user says "continue", "pick up", "where are we" or "wrap up".

Skills relacionados

steipete/notion

Notion CLI/API for pages, Markdown content, data sources, files, comments, search, Workers, and raw API calls.

community

langchain-ai/langchain

The agent engineering platform.

community

bytedance/podcast-generation

Use this skill when the user requests to generate, create, or produce podcasts from text content. Converts written content into a two-host conversational podcast audio format with natural dialogue.

community

composiohq/twitter-algorithm-optimizer

Analyze and optimize tweets for maximum reach using Twitter's open-source algorithm insights. Rewrite and edit user tweets to improve engagement and visibility based on how the recommendation system ranks content.

community

composiohq/competitive-ads-extractor

Extracts and analyzes competitors' ads from ad libraries (Facebook, LinkedIn, etc.) to understand what messaging, problems, and creative approaches are working. Helps inspire and improve your own ad campaigns.

community

upstash/context7

Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors

community
← More Redacción y edición skills