Desarrollar con IA

La documentación de Fystack está escrita para las personas y para los asistentes de IA con los que trabajan. Cada página está disponible como Markdown limpio y todo el sitio está indexado en un archivo llms.txt, para que herramientas como Claude Code, Cursor, Codex y ChatGPT puedan leer la documentación directamente en lugar de extraer HTML.

Instalar el agent skill de Fystack

Un agent skill es un paquete de instrucciones que un asistente de programación carga cuando una tarea lo requiere. El skill oficial de Fystack, fystack/agent-skills, le enseña a tu asistente a desarrollar sobre Fystack:

• API REST: cada endpoint con sus campos clave, además de la firma de solicitudes con HMAC o Ed25519 en cualquier lenguaje.
• SDK oficiales: @fystack/sdk para TypeScript y github.com/fystack/platform-sdk-go para Go.
• Webhooks: verificación de firmas y acreditación de depósitos exactamente una vez.
• Aprobaciones: roles, grupos de aprobación, límites de aprobación automática y políticas, para que pueda responder preguntas de configuración además de escribir código.

También mantiene a tu asistente en valores predeterminados seguros: desarrollar primero contra el sandbox, mantener los secretos fuera del código y nunca omitir la aprobación humana de los fondos. El skill lee esta documentación mientras trabaja, por lo que se mantiene actualizado cuando cambia la API.

Instálalo en cualquier asistente que admita agent skills, como Claude Code, Cursor, Codex, Gemini CLI y GitHub Copilot:

npx skills add fystack/agent-skills

En Claude Code, también puedes instalarlo como plugin:

/plugin marketplace add fystack/agent-skills
/plugin install fystack@fystack

Para instalarlo manualmente, copia la carpeta skills/fystack del repositorio en la carpeta de skills de tu asistente, por ejemplo .claude/skills/fystack en tu proyecto.

No necesitas mencionar el skill después de instalarlo. Pídele a tu asistente una tarea de Fystack, como crear una billetera o verificar webhooks, y cargará el skill por su cuenta.

Documentación en texto plano

Las herramientas de IA funcionan mejor con texto plano. Markdown usa muchos menos tokens que el HTML renderizado y conserva intactos los ejemplos de código, las listas de parámetros y las tablas. Fystack publica la documentación en estos formatos:

• llms.txt: https://docs.fystack.io/llms.txt es un índice breve de todas las páginas con una descripción de una línea. Indícale primero a tu asistente este archivo para que pueda encontrar la página correcta por su cuenta.
• llms-full.txt: https://docs.fystack.io/llms-full.txt contiene todas las páginas en un solo archivo. Úsalo cuando quieras que el asistente cargue toda la documentación de una vez y tu herramienta tenga espacio en su ventana de contexto.
• Páginas en Markdown: agrega .md al final de cualquier URL de la documentación para obtener esa página en Markdown, por ejemplo https://docs.fystack.io/wallets.md.
• Negociación de contenido: los agentes que envían un header Accept: text/markdown obtienen Markdown desde la URL normal de la página, sin necesidad de .md.

curl -H "Accept: text/markdown" https://docs.fystack.io/wallets

Copiar una página en tu asistente

Cada página tiene un botón Copy page junto a su título. Úsalo para:

• Copy page: copiar la página actual en Markdown, lista para pegar en cualquier chat o asistente de programación.
• View as Markdown: abrir la versión en Markdown de la página en una pestaña nueva.
• Open in ChatGPT u Open in Claude: iniciar una conversación nueva que ya apunta a la página, para que puedas hacer preguntas sobre ella de inmediato.

Protege tus claves y tus fondos