CommunityRedacción y edicióngithub.com

Varnan-Tech/opendirectory

Redacta un post para Show HN respaldado por datos reales de rendimiento. Utiliza patrones observados de los 250 mejores posts de HN para maximizar la puntuación.

¿Qué es opendirectory?

Esta habilidad ayuda a redactar publicaciones para Hacker News (HN) con un enfoque basado en datos extraídos de 250 publicaciones con mejores puntuaciones. Analiza patrones como la longitud del título, el uso del prefijo 'Show HN', la voz en primera persona, la estructura narrativa y las temáticas con mejor rendimiento (seguridad, privacidad, lanzamientos de IA, código abierto). Basándose en estos patrones, la herramienta guía al usuario a través de un proceso paso a paso: desde preguntar si se optimiza para puntuación (alcance) o comentarios (discusión), hasta determinar el tipo de publicación adecuada, redactar títulos y decidir si incluir cuerpo. Incluye una lista de verificación de autoevaluación y un formato de salida estandarizado. Es compatible con cualquier plataforma que permita ejecutar código Python (para el raspado opcional de HN) y está diseñada para agentes de IA como Claude Code, Cursor o Codex, proporcionando instrucciones precisas y reproducibles para crear publicaciones efectivas.

Compatible con✓Claude Code✓Codex CLI~Cursor✓Antigravity✓Gemini CLI
npx skills add https://github.com/Varnan-Tech/opendirectory/tree/main/skills/show-hn-writer

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

Preguntar en tu IA favorita

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

Documentación

Escritor de Show HN — Edición Basada en Datos

Esta habilidad redacta publicaciones de HN utilizando patrones extraídos de 250 publicaciones reales con las mejores puntuaciones. Cada regla proviene de datos observados, no de convenciones.


Lo que dicen los datos (internaliza esto antes de escribir nada)

Estos son los hallazgos de las 250 mejores publicaciones de HN rastreadas el 18 de abril de 2026. Invalidan cualquier conocimiento previo sobre la escritura en HN.

La longitud del título es el predictor más fuerte de la puntuación.

  • Menos de 40 caracteres: promedio 248 pts (n=82)
  • 40–59 caracteres: promedio 192 pts (n=68)
  • 60–79 caracteres: promedio 150 pts (n=91)
  • 80+ caracteres: promedio 131 pts (n=9) Objetivo predeterminado: menos de 40 caracteres. Límite estricto: 60.

El texto del cuerpo no afecta la puntuación. El 90% de las publicaciones no tenían cuerpo. Promedio con cuerpo: 189. Promedio sin cuerpo: 193. Estadísticamente idénticos. Solo vale la pena escribir un cuerpo si tienes un detalle técnico genuinamente interesante que no quepa en el título. Nunca escribas un cuerpo para aparentar credibilidad.

El prefijo Show HN suprime la puntuación. Las publicaciones Show HN promediaron 94 pts frente a 186+ de las declaraciones simples. La etiqueta indica "Quiero comentarios sobre mi proyecto", lo que provoca una lectura más escéptica. Usa "Show HN:" solo cuando el proyecto sea genuinamente novedoso. Ofrece siempre una alternativa sin prefijo.

Los títulos en primera persona superan a las declaraciones anónimas. Primera persona ("Yo…", "Mi…", "Nuestro…"): promedio 291 pts (n=9). Declaración simple: promedio 186 pts (n=126). Si la perspectiva del creador es parte de la historia, lidera con ella.

Las preguntas generan más comentarios que votos. Los títulos en forma de pregunta tienen una relación promedio comentarios-puntuación superior a 1,0×. Ideales para debates, no para puntuación bruta. Pregunta al usuario por qué optimiza antes de escribir.

Temáticas que consistentemente superan:

  • Historias de seguridad / puertas traseras / brechas: promedio 308 pts
  • Historias de privacidad / vigilancia / datos: promedio 282 pts
  • Lanzamientos de IA / LLM: promedio 266 pts (42 publicaciones — categoría más grande)
  • Lanzamientos de código abierto: promedio 485 pts (n pequeño, pero señal fuerte)

Los títulos con mayor puntuación comparten un rasgo: son historias, no temas. "Alguien compró 30 plugins de WordPress y plantó una puerta trasera en todos ellos" — 1192 pts. "Google rompió su promesa conmigo – ahora ICE tiene mis datos" — 1688 pts. Un tema es "seguridad de plugins de WordPress". Una historia tiene un actor, una acción y consecuencias.


Paso 1: Haz al usuario una pregunta antes de cualquier cosa

Antes de redactar, pregunta:

"Dos preguntas rápidas:

  1. ¿Estás optimizando para puntuación (alcance) o comentarios (discusión)?
  2. ¿Qué hace el proyecto? — una frase, técnica, sin adjetivos."

No continúes hasta que tengas ambas respuestas.


Paso 2: Determina el tipo de publicación correcto

Basado en el proyecto y el objetivo, decide qué formato usar:

Título simple (recomendado por defecto) Sin prefijo. Solo lo que es o lo que ocurrió. Mayor puntuación promedio. Úsalo cuando: compartes un lanzamiento, artículo, herramienta o evento.

Prefijo Show HN: (úsalo con moderación) Úsalo solo cuando: el proyecto es un demo funcional, el creador está presente para responder preguntas y la implementación técnica es la parte interesante. La puntuación promedio es baja (94), pero indica autenticidad cuando el proyecto es genuinamente novedoso. Redacta siempre también una alternativa de título simple para comparar.

Prefijo Ask HN: Úsalo cuando: el objetivo es la discusión, no la promoción. Relación de engagement promedio > 1,0×. Ideal para publicaciones como "¿quién usa X?" o "¿debería hacer Y?".

Prefijo Tell HN: Denuncias, rendición de cuentas o revelaciones. Un dato con 819 pts. Úsalo solo si la publicación es factual, verificable y el creador está identificado.


Paso 3: Redacta el título

El título es toda la publicación. Trata el cuerpo como opcional.

Reglas derivadas de datos:

  • Apunta a menos de 40 caracteres. Cada 20 caracteres por encima cuesta aproximadamente 30 puntos promedio.
  • Escribe una historia, no una categoría. Actor + acción + consecuencias supera a frases nominales.
  • La primera persona ("Yo…") añade ~100 pts promedio frente a declaraciones simples cuando la perspectiva del creador importa.
  • Sin adjetivos de marketing. No "rápido", "simple", "potente", "ligero" a menos que sea una especificación literal (ej. "35B-A3B" es una especificación, "potente" no lo es).
  • Especificidad supera a generalidad. "30 plugins de WordPress" supera a "plugins de CMS populares".
  • El año entre corchetes indica clásico que vale la pena leer: (2008), (1956). Úsalo al enlazar contenido antiguo que ha envejecido bien.
  • Guión largo (–) para formato de subtítulo: "Nombre del Producto – qué hace". No un guión corto (-).

Redacta tres variantes:

  1. Lo más corto posible (apunta a menos de 35 caracteres) — elimina todo lo no esencial
  2. Ángulo narrativo — actor + acción + consecuencias
  3. Ángulo técnico — lidera con la decisión de ingeniería interesante

Luego aplica la prueba de longitud: cuenta los caracteres en cada una. Marca cualquier que supere 60.


Paso 4: Decide si escribir un cuerpo

Pregúntate: ¿la implementación técnica tiene un detalle que no cabe en el título y que los ingenieros de HN encontrarían genuinamente interesante?

Si sí: escribe un cuerpo (ver Paso 5). Si no: detente en el título. Ningún cuerpo es mejor que un cuerpo inflado.

Los datos muestran que los cuerpos no aumentan la puntuación. La única razón para escribir uno es si la implementación es lo suficientemente interesante como para que los ingenieros pregunten "¿cómo funciona esto?" y quieras responder de antemano.


Paso 5: Escribe el cuerpo (solo si el Paso 4 dijo que sí)

Estructura — mantenlo ajustado:

Línea 1: Una frase. Lo que construiste y por qué. En primera persona. No "Presentando X." No "X es una herramienta que." Simplemente: "Construí X porque Y."

Líneas 2–4: La razón real. Honesta. Específica. ¿Fue un problema que tú mismo enfrentaste? ¿Algo frustrante en el trabajo? ¿Una curiosidad? "Me molestaba que..." es mejor que "Los desarrolladores a menudo luchan con...". La voz del creador es el punto.

Líneas 5–8: Cómo funciona realmente. Esto es lo que HN lee. Nombra las opciones tecnológicas específicas. Indica las compensaciones que hiciste y por qué. Una decisión de ingeniería interesante vale más que una lista de características.

Línea 9: Estado actual en una frase. ¿Código abierto? ¿Gratuito? ¿Alfa? ¿En solitario? ¿Cuánto tiempo llevas trabajando en ello?

Línea 10: Una frase final para invitar comentarios o preguntas. "Feliz de responder preguntas sobre la implementación." / "Críticas bienvenidas." Nunca pidas votos, compartidos o registros.

Reglas estrictas:

  • 150–300 palabras. Menos de 200 suele ser mejor.
  • Primera persona en todo momento.
  • Sin viñetas. Sin encabezados. Sin negritas.
  • Sin enlaces en el cuerpo. La URL va en el campo de envío.
  • Sin palabras de marketing: innovador, revolucionario, potente, robusto, sin fisuras, vanguardista, de última generación, optimizar, apalancar, transformar.

Paso 6: Autoevaluación antes de presentar

Revisa esta lista. Corrige cualquier fallo antes de generar la salida.

Título:

  • Menos de 60 caracteres (cuéntalos)
  • Sin adjetivos de marketing
  • ¿Es una historia o un tema? (historia = mejor)
  • Primera persona si la perspectiva del creador añade algo
  • Sin signos de exclamación

Cuerpo (si está escrito):

  • Comienza con "Construí…" o "Durante los últimos N meses…"
  • Contiene al menos un nombre de tecnología específica o decisión de arquitectura
  • Menos de 300 palabras
  • Sin enlaces
  • Termina con una invitación a comentarios, no una llamada a la acción
  • Cero palabras de marketing (revisa la lista en el Paso 5)

Tipo de publicación:

  • Si se usa el prefijo Show HN: ¿se ha redactado también una alternativa de título simple?
  • Si el objetivo son comentarios: ¿es una pregunta o un enfoque divisivo?
  • Si el objetivo es puntuación: ¿es una declaración, no una pregunta?

Paso 7: Presenta la salida

Formato exactamente como sigue. Sin comentarios antes ni después.

## Publicación HN

### Título recomendado
[título — la variante más corta y fuerte]

### Títulos alternativos
1. [variante 2]
2. [variante 3]

---

### Cuerpo
[texto del cuerpo, o "No recomendado — el título es suficiente." si el Paso 4 dijo que no]

---

### Notas
- Objetivo: [puntuación / comentarios] — basado en la respuesta del usuario en el Paso 1
- Tipo de publicación usado: [simple / Show HN / Ask HN / Tell HN]
- Longitud del título: [N caracteres]
- Mejor momento para publicar: martes–jueves, 8–10 AM hora del este de EE. UU.
- Después de publicar: responde a todos los comentarios en las primeras dos horas
- No compartas el enlace en otro lugar durante 24 horas — HN penaliza las redes de votos

Paso 8: Opcional — raspa las publicaciones principales actuales de HN para contexto

Si el usuario quiere verificar si se han enviado publicaciones similares recientemente, o quiere ver qué está funcionando en su categoría ahora mismo, ejecuta el raspador:

import requests
from concurrent.futures import ThreadPoolExecutor

HN_API = "https://hacker-news.firebaseio.com/v0"

def fetch_item(id_):
    try:
        r = requests.get(f"{HN_API}/item/{id_}.json", timeout=10)
        return r.json() if r.ok else None
    except Exception:
        return None

ids = requests.get(f"{HN_API}/topstories.json").json()[:250]
with ThreadPoolExecutor(max_workers=20) as ex:
    items = [i for i in ex.map(fetch_item, ids) if i]

# Filtra por palabra clave relevante al proyecto del usuario
keyword = "TU_PALABRA_CLAVE_AQUÍ"
matches = [i for i in items if keyword.lower() in i.get("title","").lower()]

for i, item in enumerate(matches, 1):
    score = item.get("score", 0)
    title = item.get("title", "")
    by = item.get("by", "")
    print(f"{i:>2}. [{score:>4}pts] {title} — {by}")

print(f"\nTotal coincidencias: {len(matches)}")

Usa los resultados para:

  • Verificar si se envió una publicación casi idéntica en las últimas 48 horas (evitar duplicación)
  • Observar qué patrones de título están teniendo éxito en esta categoría ahora mismo
  • Identificar el umbral de puntuación para esta área temática

Los resultados también se añaden a hn_log.csv automáticamente si se usa el raspador completo.


Referencia: mejores rendimientos observados del conjunto de datos

Estas son publicaciones reales del top 250. Estudia los patrones de título.

PuntuaciónTítulo
1941Claude Opus 4.7
1688Google broke its promise to me – now ICE has my data
1244Qwen3.6-35B-A3B: Agentic coding power, now open to all
1192Someone bought 30 WordPress plugins and planted a backdoor in all of them
1141DaVinci Resolve – Photo
990Codex for almost everything
982Stop Flock
909A new spam policy for "back button hijacking"
893GitHub Stacked PRs
819Tell HN: Fiverr left customer files public and searchable
668I wrote to Flock's privacy contact to opt out of their domestic spying program
619Measuring Claude 4.7's tokenizer costs
561God sleeps in the minerals
503Want to write a compiler? Just read these two papers (2008)

Mejores títulos Show HN (por puntuación): 341 | Show HN: Smol machines – subsecond coldstart, portable virtual machines 199 | Show HN: PanicLock – Close your MacBook lid disable TouchID → password unlock 187 | Show HN: Every CEO and CFO change at US public companies, live from SEC 177 | Show HN: I made a calculator that works over disjoint sets of intervals 152 | Show HN: MacMind – A transformer neural network in HyperCard on a 1989 Macintosh

Mayores relaciones comentarios-puntuación (para publicaciones optimizadas para discusión): 1.91× | Why is IPv6 so complicated? 1.43× | Ask HN: Building a solo business is impossible? 1.20× | Ohio prison inmates built computers and hid them in ceiling 1.13× | Ask HN: Who is using OpenClaw? 1.05× | The future of everything is lies, I guess: Where do we go from here?

Individual skills in this repo

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

Varnan-Tech/opendirectory

Use when the user asks to generate a blog cover image, thumbnail, or article header. Automatically uses modern typography, brand logos, and Google Search grounding to create beautiful 16:9 images with Gemini 3.1 Flash Image Preview.

Varnan-Tech/opendirectory

World-class brand strategist and naming expert. Uses an interrogation-led discovery phase to extract your brand's DNA, then applies scientific naming frameworks (Phonosemantics) and automated multi-TLD domain checking.

Varnan-Tech/opendirectory

Use when the user asks to generate or update a project's CLAUDE or AGENTS context file from a codebase scan. Writes a focused file under 100 lines containing only the non-obvious build commands, conventions, and gotchas Claude Code needs.

Varnan-Tech/opendirectory

Use when the user wants to verify cold emails, enrich a lead list, or autonomously guess email addresses from a CSV using ValidEmail.co or the open-source Reacher engine.

Varnan-Tech/opendirectory

Competitive intelligence orchestrator tracking companies across 8+ platforms (GitHub, Twitter, Reddit, HN, PH, YC Jobs) with heat scores and AI briefings.

Varnan-Tech/opendirectory

Give it your product URL or description. It finds your top 5 competitors, runs three-track PR research across all of them (editorial, podcasts, communities), identifies which channels appear most frequently, looks up the journalist or host for each, and returns a tiered outreach list with story angles and ready-to-send cold pitch drafts tailored to your product. Use when asked to find PR opportunities, discover where competitors got featured, build a media outreach list, find which journalists cover my space, or get pitch templates for press coverage.

Varnan-Tech/opendirectory

Generate high-converting, deep-dive growth case studies in MDX format. Use this skill when asked to write a case study or blog post about a company's growth, tech stack, or product-led strategy. It handles the full pipeline (researching the company via Tavily, generating a 16:9 cover image, quality checking the draft, uploading assets to cloud storage, and pushing directly to the target repository).

Varnan-Tech/opendirectory

Scans your project for outdated npm, pip, Cargo, Go, or Ruby packages. Runs a CVE security audit. Fetches changelogs, summarizes breaking changes with Gemini, and opens one PR per risk group (patch, minor, major). Includes Diagnosis Mode for install conflicts. Use when asked to update dependencies, check for outdated packages, open dependency PRs, scan for package updates, audit for CVEs, or flag breaking changes in upgrades. Trigger when a user says "check for outdated packages", "update my dependencies", "open PRs for dependency updates", "scan for CVEs", or "which packages need upgrading".

Varnan-Tech/opendirectory

Generates and updates README.md and API reference docs by reading your codebase's functions, routes, types, schemas, and architecture. Uses graphify to build a knowledge graph first, then writes accurate docs from it. Use when asked to write docs, generate a README, document an API, update stale docs, create an API reference from code, add an architecture section, or document a project in any language. Trigger when a user says their docs are missing, outdated, or wants to document their codebase without writing it manually.

Varnan-Tech/opendirectory

Evaluates expired domain candidates against a target niche, scores them by topical relevance, historical activity level, and history cleanliness, then outputs a ranked shortlist with explainable reasoning and risk flags.

Varnan-Tech/opendirectory

Brutally honest developer-experience audit for a GitHub repo. Scores 10 DX dimensions (time-to-first-success, README clarity, visual proof, install, quick-start, docs, examples, community, trust, marketing), writes a shareable roast in the requested tone (brutal/honest/kind), produces a prioritized action plan ranked by impact × effort, and sketches an ideal README. Trigger when user says "roast my repo", "audit my README", "dx audit", "developer experience review", "score my GitHub project", "before launch checklist", or "make my repo shareable".

Varnan-Tech/opendirectory

Drafts and designs a complete HTML email newsletter from a topic or content brief. Outputs paste-ready HTML for Loops, Mailchimp, Beehiiv, Resend, or any standard email platform. Includes subject line options and plain-text fallback. Trigger when a user says "write a newsletter", "draft an email newsletter", "create an HTML email", "design an email for my subscribers", or "write a newsletter about [topic]".

Varnan-Tech/opendirectory

Takes a GitHub PR URL or the current branch and writes a plain-English explanation of what it does and why, then posts it as a PR comment. Use when asked to explain a PR, summarize a pull request, write a plain-English description of a PR, add a summary comment to a PR, or understand what a PR changes. Trigger when a user says "explain this PR", "summarize this pull request", "what does this PR do", "add a comment explaining the PR", or shares a GitHub PR URL and asks what it does.

Varnan-Tech/opendirectory

Audit how often LLMs recommend your brand vs competitors and generate a GEO action plan.

Varnan-Tech/opendirectory

Takes a competitor's public GitHub repo URL, fetches their open issues via the GitHub REST API, filters noise locally, clusters issues into 6 demand categories, computes a demand score per issue and per cluster, and outputs a ranked demand gap report with a GTM messaging brief. Use when asked to scan a competitor's GitHub issues, find what their users are begging for, turn GitHub complaints into product positioning, identify competitor feature gaps, or generate messaging from real user demand. Trigger when a user says "scan competitor issues", "what are users asking for on X repo", "find demand gaps in Y", "turn GitHub issues into messaging", or "what should I build based on competitor complaints".

Varnan-Tech/opendirectory

Find recurring confusion in your repo's GitHub Discussions, rank it by urgency, and draft the actual docs fixes and content angles — with verbatim community quotes and source links as evidence.

Varnan-Tech/opendirectory

SEO keyword research workflow for blog generation using Google Trends data. Use when writing blog posts, planning content calendars, or optimizing articles for search engines. Finds breakout keywords, builds content structure, and generates SEO-optimized blog outlines targeting tech and developer audiences.

Varnan-Tech/opendirectory

Generates a professionally designed case study PDF for B2B SaaS sales and marketing. Supports 7 page layouts, 9 style presets, 1-4 page output. Trigger when user says "create a case study", "write a customer story", "make a case study PDF", "design a success story", "turn this customer win into a PDF".

Varnan-Tech/opendirectory

Generates data visualization charts (bar, line, area, pie, doughnut, scatter, radar, treemap) as PNG using Apache ECharts v6. 1080×1080px default, 5 style presets, highlight annotations. Trigger when user says "create a chart", "visualize data", "make a bar chart", "line graph", "pie chart", "data visualization", "chart this data", "plot", "graph", or "visualize these numbers".

Varnan-Tech/opendirectory

Fetches low-star App Store and Google Play reviews, clusters them into broken-promise patterns, and generates a ranked copy brief with positioning opportunities.

Skills relacionados