docs(ia): add Agent Skills page under the AI section

src/content/docs/modules/mcp/en/agent-skills.ts

@@ -0,0 +1,73 @@
+import type { DocPage } from "@/@types/docs";
+
+export const agentSkills: DocPage = {
+  slug: "agent-skills",
+  title: "Agent Skills",
+  section: "AI",
+  tocItems: [
+    "What it is",
+    "Install",
+    "What the skill covers",
+    "How it works",
+    "Skill vs MCP",
+    "Source of truth",
+  ],
+  content: `
+# Agent Skills
+
+The **ACTA Agent Skill** teaches an AI coding agent how to build with ACTA correctly. It is published as an open [Agent Skill](https://www.skills.sh) that installs into Claude Code, Cursor, GitHub Copilot, Windsurf, Gemini, and other MCP or skill-compatible agents.
+
+Use it when you want your coding agent to write ACTA integrations without guessing: the right package name, base URLs, the prepare/submit flow, \`did:stellar\` issuer identity, error codes, and the security model all come from the official docs instead of stale training data.
+
+- **Directory:** [skills.sh/ACTA-Team/skills](https://www.skills.sh/ACTA-Team/skills)
+- **Source:** [github.com/ACTA-Team/skills](https://github.com/ACTA-Team/skills)
+
+## What it is
+
+A skill is a reusable folder (a \`SKILL.md\` plus references and examples) that an agent loads as context. The agent reads the skill's description, decides it is relevant to your ACTA task, and follows its instructions in place of guessing. See [AI Overview](doc:ai-overview) for how skills fit next to the other AI tooling.
+
+## Install
+
+Install into any supported agent with the skills CLI:
+
+\`\`\`bash
+# Install every skill in the repo
+npx skills add ACTA-Team/skills
+
+# Or install just the acta skill
+npx skills add ACTA-Team/skills/acta
+\`\`\`
+
+The CLI writes the skill into your agent's skills directory (for example \`.claude/skills/\` for Claude Code) and the agent picks it up automatically. See the [skills.sh docs](https://www.skills.sh/docs) for per-agent details.
+
+You can also copy the \`acta/\` folder from the repo directly into your agent's skills directory.
+
+## What the skill covers
+
+- The \`@acta-team/credentials\` React SDK: \`ActaConfig\`, \`useCredential\`, \`useVault\`, \`useVaultRead\`, \`useActaClient\`, and \`ActaClient\`.
+- The REST API: \`/contracts/*\` endpoints, the \`X-ACTA-Key\` header, the prepare/submit XDR flow, ownership rules, rate limits, and idempotency.
+- \`did:stellar\` issuer and holder identity, resolution, and issuer verification.
+- Vaults: single-tenant, deterministic addressing, sponsored vaults, and push.
+- Error handling: HTTP codes, validation, issuer-DID errors, contract errors, and the mainnet USDC fee failures.
+- The security and data model: who signs what, what is on-chain versus encrypted.
+
+The skill is structured for progressive disclosure: a concise \`SKILL.md\` entry point, with deeper material in \`references/\` and runnable code in \`examples/\`.
+
+## How it works
+
+[skills.sh](https://www.skills.sh) has no separate publish step. A repository is indexed automatically through anonymous install telemetry the first time someone runs \`npx skills add ACTA-Team/skills\`. The more it is installed, the higher it ranks in the directory.
+
+## Skill vs MCP
+
+The skill and the [MCP server](doc:mcp) are complementary:
+
+- The **skill** ships opinionated, ready-to-use integration guidance that the agent follows while writing code.
+- The **MCP** (\`@acta-team/docs-mcp\`) lets the agent query the live official documentation on demand.
+
+Install both for the best result: the skill for how to build, the MCP for looking things up.
+
+## Source of truth
+
+The skill is distilled from the official documentation at [docs.acta.build](https://docs.acta.build). When a detail in the skill conflicts with the live docs, the live docs win.
+  `,
+};

src/content/docs/modules/mcp/en/index.ts

@@ -1,12 +1,14 @@
 import type { DocPage } from "@/@types/docs";
 import { aiOverview } from "./ai-overview";
+import { agentSkills } from "./agent-skills";
 import { mcp } from "./mcp";
 import { mcpClients } from "./mcp-clients";
 import { aiPrompts } from "./ai-prompts";
 import { agentIdentity } from "./agent-identity";
 
 export const pages: Record<string, DocPage> = {
   "ai-overview": aiOverview,
+  "agent-skills": agentSkills,
   mcp,
   "mcp-clients": mcpClients,
   "ai-prompts": aiPrompts,

src/content/docs/modules/mcp/es/agent-skills.ts

@@ -0,0 +1,73 @@
+import type { DocPage } from "@/@types/docs";
+
+export const agentSkills: DocPage = {
+  slug: "agent-skills",
+  title: "Agent Skills",
+  section: "AI",
+  tocItems: [
+    "Qué es",
+    "Instalación",
+    "Qué cubre la skill",
+    "Cómo funciona",
+    "Skill vs MCP",
+    "Fuente de verdad",
+  ],
+  content: `
+# Agent Skills
+
+La **Agent Skill de ACTA** le enseña a un agente de IA de programación a construir con ACTA de forma correcta. Se publica como una [Agent Skill](https://www.skills.sh) abierta que se instala en Claude Code, Cursor, GitHub Copilot, Windsurf, Gemini y otros agentes compatibles con MCP o con skills.
+
+Úsala cuando quieras que tu agente escriba integraciones de ACTA sin adivinar: el nombre correcto del paquete, las URLs base, el flujo prepare/submit, la identidad de emisor \`did:stellar\`, los códigos de error y el modelo de seguridad salen de la documentación oficial y no de datos de entrenamiento desactualizados.
+
+- **Directorio:** [skills.sh/ACTA-Team/skills](https://www.skills.sh/ACTA-Team/skills)
+- **Código:** [github.com/ACTA-Team/skills](https://github.com/ACTA-Team/skills)
+
+## Qué es
+
+Una skill es una carpeta reutilizable (un \`SKILL.md\` más referencias y ejemplos) que el agente carga como contexto. El agente lee la descripción de la skill, decide que es relevante para tu tarea de ACTA y sigue sus instrucciones en lugar de adivinar. Consulta el [Resumen de IA](doc:ai-overview) para ver cómo encajan las skills junto al resto del tooling de IA.
+
+## Instalación
+
+Instálala en cualquier agente compatible con el CLI de skills:
+
+\`\`\`bash
+# Instalar todas las skills del repo
+npx skills add ACTA-Team/skills
+
+# O solo la skill acta
+npx skills add ACTA-Team/skills/acta
+\`\`\`
+
+El CLI escribe la skill en el directorio de skills de tu agente (por ejemplo \`.claude/skills/\` en Claude Code) y el agente la toma automáticamente. Consulta la [documentación de skills.sh](https://www.skills.sh/docs) para detalles por agente.
+
+También puedes copiar la carpeta \`acta/\` del repo directamente en el directorio de skills de tu agente.
+
+## Qué cubre la skill
+
+- El SDK de React \`@acta-team/credentials\`: \`ActaConfig\`, \`useCredential\`, \`useVault\`, \`useVaultRead\`, \`useActaClient\` y \`ActaClient\`.
+- La API REST: endpoints \`/contracts/*\`, el header \`X-ACTA-Key\`, el flujo prepare/submit con XDR, reglas de propiedad, límites de tasa e idempotencia.
+- Identidad de emisor y titular con \`did:stellar\`, resolución y verificación del emisor.
+- Vaults: single-tenant, direccionamiento determinista, vaults patrocinados y push.
+- Manejo de errores: códigos HTTP, validación, errores de issuer-DID, errores de contrato y los fallos de fee en USDC en mainnet.
+- El modelo de seguridad y datos: quién firma qué, qué vive on-chain y qué está cifrado.
+
+La skill está estructurada para divulgación progresiva: un \`SKILL.md\` conciso como entrada, con el detalle en \`references/\` y código ejecutable en \`examples/\`.
+
+## Cómo funciona
+
+[skills.sh](https://www.skills.sh) no tiene un paso de publicación separado. Un repositorio se indexa automáticamente mediante telemetría anónima de instalación la primera vez que alguien ejecuta \`npx skills add ACTA-Team/skills\`. Cuanto más se instala, más sube en el directorio.
+
+## Skill vs MCP
+
+La skill y el [servidor MCP](doc:mcp) son complementarios:
+
+- La **skill** entrega guía de integración lista para usar que el agente sigue mientras escribe código.
+- El **MCP** (\`@acta-team/docs-mcp\`) le permite al agente consultar la documentación oficial en vivo cuando la necesita.
+
+Instala ambos para el mejor resultado: la skill para saber cómo construir, el MCP para consultar.
+
+## Fuente de verdad
+
+La skill está destilada de la documentación oficial en [docs.acta.build](https://docs.acta.build). Cuando un detalle de la skill entre en conflicto con la documentación en vivo, manda la documentación en vivo.
+  `,
+};

src/content/docs/modules/mcp/es/index.ts

@@ -1,12 +1,14 @@
 import type { DocPage } from "@/@types/docs";
 import { aiOverview } from "./ai-overview";
+import { agentSkills } from "./agent-skills";
 import { mcp } from "./mcp";
 import { mcpClients } from "./mcp-clients";
 import { aiPrompts } from "./ai-prompts";
 import { agentIdentity } from "./agent-identity";
 
 export const pages: Record<string, DocPage> = {
   "ai-overview": aiOverview,
+  "agent-skills": agentSkills,
   mcp,
   "mcp-clients": mcpClients,
   "ai-prompts": aiPrompts,

src/content/docs/modules/mcp/fr/agent-skills.ts

@@ -0,0 +1,73 @@
+import type { DocPage } from "@/@types/docs";
+
+export const agentSkills: DocPage = {
+  slug: "agent-skills",
+  title: "Agent Skills",
+  section: "AI",
+  tocItems: [
+    "Ce que c'est",
+    "Installation",
+    "Ce que couvre la skill",
+    "Comment ça marche",
+    "Skill vs MCP",
+    "Source de vérité",
+  ],
+  content: `
+# Agent Skills
+
+L'**Agent Skill ACTA** apprend à un agent de codage IA à construire correctement avec ACTA. Elle est publiée comme une [Agent Skill](https://www.skills.sh) ouverte qui s'installe dans Claude Code, Cursor, GitHub Copilot, Windsurf, Gemini et d'autres agents compatibles MCP ou skills.
+
+Utilisez-la pour que votre agent écrive des intégrations ACTA sans deviner : le bon nom de paquet, les URLs de base, le flux prepare/submit, l'identité d'émetteur \`did:stellar\`, les codes d'erreur et le modèle de sécurité proviennent de la documentation officielle et non de données d'entraînement obsolètes.
+
+- **Répertoire :** [skills.sh/ACTA-Team/skills](https://www.skills.sh/ACTA-Team/skills)
+- **Source :** [github.com/ACTA-Team/skills](https://github.com/ACTA-Team/skills)
+
+## Ce que c'est
+
+Une skill est un dossier réutilisable (un \`SKILL.md\` plus des références et des exemples) que l'agent charge comme contexte. L'agent lit la description de la skill, décide qu'elle est pertinente pour votre tâche ACTA, et suit ses instructions au lieu de deviner. Voir l'[Aperçu de l'IA](doc:ai-overview) pour situer les skills parmi les autres outils IA.
+
+## Installation
+
+Installez-la dans n'importe quel agent compatible avec le CLI skills :
+
+\`\`\`bash
+# Installer toutes les skills du dépôt
+npx skills add ACTA-Team/skills
+
+# Ou seulement la skill acta
+npx skills add ACTA-Team/skills/acta
+\`\`\`
+
+Le CLI écrit la skill dans le répertoire de skills de votre agent (par exemple \`.claude/skills/\` pour Claude Code) et l'agent la prend en compte automatiquement. Voir la [documentation skills.sh](https://www.skills.sh/docs) pour les détails par agent.
+
+Vous pouvez aussi copier le dossier \`acta/\` du dépôt directement dans le répertoire de skills de votre agent.
+
+## Ce que couvre la skill
+
+- Le SDK React \`@acta-team/credentials\` : \`ActaConfig\`, \`useCredential\`, \`useVault\`, \`useVaultRead\`, \`useActaClient\` et \`ActaClient\`.
+- L'API REST : endpoints \`/contracts/*\`, l'en-tête \`X-ACTA-Key\`, le flux prepare/submit XDR, les règles de propriété, les limites de débit et l'idempotence.
+- L'identité d'émetteur et de titulaire \`did:stellar\`, la résolution et la vérification de l'émetteur.
+- Les vaults : single-tenant, adressage déterministe, vaults sponsorisés et push.
+- La gestion des erreurs : codes HTTP, validation, erreurs issuer-DID, erreurs de contrat et les échecs de frais USDC sur mainnet.
+- Le modèle de sécurité et de données : qui signe quoi, ce qui est on-chain versus chiffré.
+
+La skill est structurée pour une divulgation progressive : un \`SKILL.md\` concis comme point d'entrée, avec le détail dans \`references/\` et du code exécutable dans \`examples/\`.
+
+## Comment ça marche
+
+[skills.sh](https://www.skills.sh) n'a pas d'étape de publication séparée. Un dépôt est indexé automatiquement via une télémétrie d'installation anonyme la première fois que quelqu'un exécute \`npx skills add ACTA-Team/skills\`. Plus elle est installée, plus elle monte dans le répertoire.
+
+## Skill vs MCP
+
+La skill et le [serveur MCP](doc:mcp) sont complémentaires :
+
+- La **skill** fournit des conseils d'intégration prêts à l'emploi que l'agent suit pendant qu'il écrit du code.
+- Le **MCP** (\`@acta-team/docs-mcp\`) permet à l'agent d'interroger la documentation officielle en direct à la demande.
+
+Installez les deux pour un résultat optimal : la skill pour savoir comment construire, le MCP pour la consultation.
+
+## Source de vérité
+
+La skill est distillée de la documentation officielle sur [docs.acta.build](https://docs.acta.build). Lorsqu'un détail de la skill entre en conflit avec la documentation en direct, la documentation en direct prévaut.
+  `,
+};

src/content/docs/modules/mcp/fr/index.ts

@@ -1,6 +1,8 @@
 import type { DocPage } from "@/@types/docs";
+import { agentSkills } from "./agent-skills";
 import { mcp } from "./mcp";
 
 export const pages: Record<string, DocPage> = {
+  "agent-skills": agentSkills,
   mcp,
 };

src/content/docs/navigation/en.ts

@@ -48,6 +48,7 @@ export const navigation: NavigationItems = {
   ],
   ia: [
     { slug: "ai-overview", title: "AI Overview" },
+    { slug: "agent-skills", title: "Agent Skills" },
     { slug: "mcp", title: "MCP" },
     { slug: "mcp-clients", title: "MCP Client Setup" },
     { slug: "ai-prompts", title: "Prompt Recipes" },

src/content/docs/navigation/es.ts

@@ -48,6 +48,7 @@ export const navigation: NavigationItems = {
   ],
   ia: [
     { slug: "ai-overview", title: "Resumen de IA" },
+    { slug: "agent-skills", title: "Agent Skills" },
     { slug: "mcp", title: "MCP" },
     { slug: "mcp-clients", title: "Configuración por Cliente" },
     { slug: "ai-prompts", title: "Recetas de Prompts" },

src/content/docs/navigation/fr.ts

@@ -46,7 +46,10 @@ export const navigation: NavigationItems = {
     { slug: "did-registry", title: "Registre et Resolver" },
     { slug: "did-library", title: "Bibliothèque TypeScript" },
   ],
-  ia: [{ slug: "mcp", title: "MCP" }],
+  ia: [
+    { slug: "agent-skills", title: "Agent Skills" },
+    { slug: "mcp", title: "MCP" },
+  ],
   dapp: [
     { slug: "dapp-overview", title: "Aperçu" },
     { slug: "dapp-getting-started", title: "Premiers Pas" },

src/layouts/app-shell/shared.tsx

@@ -39,6 +39,7 @@ import {
   Network,
   Package,
   Plug,
+  Puzzle,
   Rocket,
   ScanSearch,
   ScrollText,
@@ -112,6 +113,7 @@ const NAV_SUB_ITEM_ICONS: Partial<Record<string, LucideIcon>> = {
   "did-registry": Server,
   "did-library": Braces,
   "ai-overview": Sparkles,
+  "agent-skills": Puzzle,
   mcp: Cable,
   "mcp-clients": Plug,
   "ai-prompts": Lightbulb,