{ "$schema": "https://docs.farming-labs.dev/schema/agent-manifest.v2.json", "format": "farming-labs-agent-manifest.v2", "version": "2", "name": "@farming-labs/docs", "profile": "full", "profiles": { "default": "full", "full": "/.well-known/agent.json", "compact": "/.well-known/agent.json?profile=compact" }, "baseUrl": "https://farming-labs-docs-docs-cloud-efopyzg1t-farming-labs.vercel.app", "site": { "title": "Documentation", "description": "An AI-native documentation framework for Next.js, TanStack Start, SvelteKit, Astro, and Nuxt.", "entry": "docs", "baseUrl": "https://docs.farming-labs.dev" }, "locales": { "enabled": false, "available": [], "default": null, "queryParam": "lang", "fallbackQueryParam": "locale" }, "capabilities": { "markdownRoutes": true, "markdownSectionDiscovery": true, "agentMdOverrides": true, "agentBlocks": true, "structuredAgentContracts": true, "agents": true, "llms": true, "skills": true, "apiCatalog": true, "agentSkillsDiscovery": true, "mcp": true, "search": true, "contentChanges": true, "sitemap": true, "robots": true, "structuredData": true, "apiReference": false, "openapi": false, "agentFeedback": true, "locales": false }, "api": { "docs": "/api/docs", "config": "/api/docs?format=config", "diagnostics": "/api/docs?format=diagnostics", "agentSpec": "/api/docs/agent/spec", "agentSpecDefault": "/.well-known/agent.json", "agentSpecFallback": "/.well-known/agent", "agentSpecWellKnown": "/.well-known/agent", "agentSpecWellKnownJson": "/.well-known/agent.json", "agentSpecQuery": "/api/docs?agent=spec", "agents": "/api/docs?format=agents", "apiCatalog": "/.well-known/api-catalog", "apiCatalogQuery": "/api/docs?format=api-catalog", "agentSkillsIndex": "/.well-known/agent-skills/index.json", "legacySkillsIndex": "/.well-known/skills/index.json", "openapi": "/api/docs?format=openapi", "contentChanges": "/api/docs?audience=agent&response=changes" }, "apiCatalog": { "enabled": true, "route": "/.well-known/api-catalog", "api": "/api/docs?format=api-catalog", "mediaType": "application/linkset+json", "profile": "https://www.rfc-editor.org/info/rfc9727" }, "config": { "format": "docs-config-map.v1", "endpoint": "/api/docs?format=config" }, "markdown": { "enabled": true, "acceptHeader": "text/markdown", "signatureAgentHeader": "Signature-Agent", "pagePattern": "/docs/{slug}.md", "rootPage": "/docs.md", "apiPattern": "/api/docs?format=markdown&path={slug}", "sectionDiscovery": { "enabled": true, "format": "docs-markdown-sections.v2", "indexParam": "sections", "sectionParam": "section", "tokenBudgetParam": "tokenBudget", "byteBudgetParam": "byteBudget" }, "resolutionOrder": [ "agent.md", "agent audience projection", "shared page markdown" ] }, "agentContract": { "enabled": true, "schemaVersion": "page-agent-contract.v1", "source": "page-frontmatter", "frontmatterPath": "agent", "markdownSection": "Agent Contract", "mcpField": "agent", "mcpTools": { "list": "list_tasks", "read": "read_task" }, "usefulContractFields": [ "task", "outcome" ], "fields": { "tokenBudget": "number", "access": "{visibility?,scopes?,claims?}", "task": "string", "outcome": "string", "appliesTo": { "framework": "string|string[]", "version": "string|string[]", "package": "string|string[]" }, "prerequisites": "string[]", "files": "string[]", "commands": "Array", "sideEffects": "string[]", "verification": "Array", "rollback": "string[]", "failureModes": "Array" } }, "llms": { "enabled": true, "defaultTxt": "/llms.txt", "defaultFull": "/llms-full.txt", "txt": "/api/docs?format=llms", "full": "/api/docs?format=llms-full", "publicTxt": "/llms.txt", "publicFull": "/llms-full.txt", "wellKnownTxt": "/.well-known/llms.txt", "wellKnownFull": "/.well-known/llms-full.txt", "sections": [ { "title": "Migrations", "description": "Source-specific migration guides for moving existing documentation into Farming Labs Docs.", "match": [ "/docs/migrations/**" ], "txt": "/docs/migrations/llms.txt", "full": "/docs/migrations/llms-full.txt" }, { "title": "Guides", "description": "Task-based guides for agent-friendly docs and discovery surfaces.", "match": [ "/docs/guides/**" ], "txt": "/docs/guides/llms.txt", "full": "/docs/guides/llms-full.txt" }, { "title": "Customization", "description": "Configuration guides for AI chat, MCP, analytics, sitemaps, and theming.", "match": [ "/docs/customization/**" ], "txt": "/docs/customization/llms.txt", "full": "/docs/customization/llms-full.txt" }, { "title": "Themes", "description": "Theme previews and theme creation guides.", "match": [ "/docs/themes/**" ], "txt": "/docs/themes/llms.txt", "full": "/docs/themes/llms-full.txt" } ] }, "sitemap": { "enabled": true, "xml": { "enabled": true, "route": "/sitemap.xml", "api": "/api/docs?format=sitemap-xml", "defaultRoute": "/sitemap.xml" }, "markdown": { "enabled": true, "route": "/sitemap.md", "docsRoute": "/docs/sitemap.md", "wellKnownRoute": "/.well-known/sitemap.md", "api": "/api/docs?format=sitemap-md", "defaultRoute": "/sitemap.md", "defaultDocsRoute": "/docs/sitemap.md", "defaultWellKnownRoute": "/.well-known/sitemap.md" } }, "robots": { "enabled": true, "route": "/robots.txt", "defaultRoute": "/robots.txt" }, "structuredData": { "enabled": true, "format": "application/ld+json", "schema": "https://schema.org/TechArticle", "fields": [ "headline", "description", "url", "dateModified", "breadcrumb", "mainEntity" ], "canonicalUrlField": "url", "breadcrumbType": "BreadcrumbList", "agentContractType": "HowTo" }, "openapi": { "enabled": false, "url": null, "source": null, "specUrl": null, "apiReferencePath": null, "versions": [], "format": "OpenAPI 3.1" }, "search": { "enabled": true, "endpoint": "/api/docs?query={query}", "agentEndpoint": "/api/docs?query={query}&audience=agent", "structuredAgentEndpoint": "/api/docs?query={query}&audience=agent&response=structured", "explainedAgentEndpoint": "/api/docs?query={query}&audience=agent&response=structured&explain=true", "facetsEndpoint": "/api/docs?audience=agent&response=facets", "method": "GET", "queryParam": "query", "localeParam": "lang", "audienceParam": "audience", "defaultAudience": "human", "supportedAudiences": [ "human", "agent" ], "responseParam": "response", "structuredResponseValue": "structured", "facetsResponseValue": "facets", "responseFormat": "docs-search.v1", "explainParam": "explain", "explainValue": "true", "explanationField": "explanation", "explanationFormat": "docs-search-explanation.v1", "facetsResponseFormat": "docs-search-facets.v1", "filterParams": { "framework": "framework", "version": "version", "package": "package", "tags": "tags" }, "repeatedFilterParams": [ "framework", "version", "package", "tags" ], "warningsField": "warnings", "facetParam": "facet", "limitParam": "limit", "cursorParam": "cursor", "nextCursorField": "nextCursor", "hasMoreField": "hasMore", "totalField": "total" }, "contentChanges": { "enabled": true, "endpoint": "/api/docs?audience=agent&response=changes", "method": "GET", "audienceParam": "audience", "defaultAudience": "agent", "supportedAudiences": [ "human", "agent" ], "responseParam": "response", "responseValue": "changes", "sinceParam": "since", "format": "docs-content-changes.v1", "generationField": "indexGeneration", "resetRequiredField": "resetRequired", "modes": [ "snapshot", "delta", "reset" ], "bodyFree": true, "etag": true }, "agents": { "enabled": true, "file": "AGENTS.md", "route": "/AGENTS.md", "wellKnown": "/.well-known/AGENTS.md", "api": "/api/docs?format=agents", "generatedFallback": true, "aliases": [ "/AGENT.md", "/.well-known/AGENT.md" ] }, "skills": { "enabled": true, "file": "skill.md", "route": "/skill.md", "wellKnown": "/.well-known/skill.md", "api": "/api/docs?format=skill", "generatedFallback": true, "registry": "skills.sh", "install": "npx skills add farming-labs/docs", "discovery": { "schema": "https://schemas.agentskills.io/discovery/0.2.0/schema.json", "index": "/.well-known/agent-skills/index.json", "artifact": "/.well-known/agent-skills/{name}/SKILL.md", "archive": "/.well-known/agent-skills/{name}.tar.gz", "file": "/.well-known/agent-skills/{name}/{path}", "legacyIndex": "/.well-known/skills/index.json", "apiIndex": "/api/docs?format=agent-skills", "apiArtifact": "/api/docs?format=agent-skill&name={name}", "apiFile": "/api/docs?format=agent-skill-file&name={name}&path={path}", "digest": "sha256" }, "published": [ { "name": "docs", "description": "Use the Farming Labs docs website through standards discovery, AGENTS.md, markdown routes, search, llms.txt, OpenAPI schema discovery, and MCP.", "type": "skill-md", "url": "/.well-known/agent-skills/docs/SKILL.md", "digest": "sha256:78cfb853207f45c2d2fad09125a669b5ce592f674162f0fa57795c7b9bd7c8a3", "files": [ { "path": "SKILL.md", "url": "/.well-known/agent-skills/docs/SKILL.md", "digest": "sha256:78cfb853207f45c2d2fad09125a669b5ce592f674162f0fa57795c7b9bd7c8a3" } ] }, { "name": "ask-ai", "description": "Configure the Ask AI (RAG-powered AI chat) in @farming-labs/docs. Use when enabling AI chat, setting mode (search vs floating), floatingStyle (panel, modal, popover, full-modal), position, providers, models, suggestedQuestions, apiKey, systemPrompt, maxResults, useMcp, feedback, or onActions. Covers Next.js, TanStack Start, SvelteKit, Astro, Nuxt, and env vars.", "type": "skill-md", "url": "/.well-known/agent-skills/ask-ai/SKILL.md", "digest": "sha256:b826b57a7206a72912d91977f1b99d9748deaacb95cd5874bb36922ef90c8b50", "files": [ { "path": "SKILL.md", "url": "/.well-known/agent-skills/ask-ai/SKILL.md", "digest": "sha256:b826b57a7206a72912d91977f1b99d9748deaacb95cd5874bb36922ef90c8b50" } ] }, { "name": "cli", "description": "Use the @farming-labs/docs CLI to scaffold projects or Agent Skills, upgrade, downgrade, deploy, audit, compare OpenAPI contracts, generate typed OpenAPI SDKs, review, export or compact agent docs, validate code blocks, generate discovery files, sync search indexes, and run MCP. Use for init, deploy, upgrade, downgrade, doctor, openapi diff, openapi sdk, api aliases, review, agent export, agent compact, skills scaffold, codeblocks validate, agents generate, sitemap generate, robots generate, search sync, mcp, and their flags.", "type": "archive", "url": "/.well-known/agent-skills/cli.tar.gz", "digest": "sha256:273ff0ebd538b0367bc905e9a9bb19578f554db532aa48859237f119efdd86b8", "files": [ { "path": "SKILL.md", "url": "/.well-known/agent-skills/cli/SKILL.md", "digest": "sha256:5f339f4f0c4bfdcef9418063d07dc74ec6d36827035e02a5f5f0afe1eddf1a88" }, { "path": "references/agent-and-static-outputs.md", "url": "/.well-known/agent-skills/cli/references/agent-and-static-outputs.md", "digest": "sha256:18e394674a4fb4c0e5aba3f6c7aae6b3a8bcef0c371eedb8b66afd1f00255a29" }, { "path": "references/doctor-audits.md", "url": "/.well-known/agent-skills/cli/references/doctor-audits.md", "digest": "sha256:9ff9ab818c4a2ab2d420f3b9355410535cbd5c1c7c212cbbca563b48314efaa9" }, { "path": "references/init-and-package-versions.md", "url": "/.well-known/agent-skills/cli/references/init-and-package-versions.md", "digest": "sha256:2882d0016654eb88eb7204095a3e595cf4044bffc00336c1ef414c1f9daca5ac" }, { "path": "references/mcp-cloud-and-search.md", "url": "/.well-known/agent-skills/cli/references/mcp-cloud-and-search.md", "digest": "sha256:009e707d44599ffd4fd1ed1f9a61a57f2859f51bd8bf045f56c8cf091c550a93" }, { "path": "references/openapi-diffs.md", "url": "/.well-known/agent-skills/cli/references/openapi-diffs.md", "digest": "sha256:d7a6644acd4a3fb5d11ae74876541a5b9b1b68c4bddc76af57c0833676ee5092" }, { "path": "references/openapi-sdks.md", "url": "/.well-known/agent-skills/cli/references/openapi-sdks.md", "digest": "sha256:c1bee2475368fd10123c7260c5432ee7bec8a1d29cbe7ff6a64e3e5d94dddfad" }, { "path": "references/validation-and-review.md", "url": "/.well-known/agent-skills/cli/references/validation-and-review.md", "digest": "sha256:34219d8ed2071516f505fd85f76701605d6c2f6279b40d00bc2171776368c72f" } ] }, { "name": "configuration", "description": "docs.config.ts options for @farming-labs/docs. Use when configuring entry, contentDir, theme, staticExport, navigation, search, feedback, agent surfaces, MCP, API references, review, metadata, or framework-specific config wiring for Next.js, TanStack Start, Farm.js, SvelteKit, Astro, and Nuxt.", "type": "archive", "url": "/.well-known/agent-skills/configuration.tar.gz", "digest": "sha256:624ec24b452db2635b75eddb4dc26f44cc3966f3f3c5ee9ccdd51d86b6ee7537", "files": [ { "path": "SKILL.md", "url": "/.well-known/agent-skills/configuration/SKILL.md", "digest": "sha256:4ccd89a235d2f41e555de8f68475425e3d91a92093d82adf92bc17f26a834522" }, { "path": "references/agent-content-and-discovery.md", "url": "/.well-known/agent-skills/configuration/references/agent-content-and-discovery.md", "digest": "sha256:040c58d8b69a6727f31e7d3e2714594a849cea07029e585df5039cf9fe2659f7" }, { "path": "references/agent-skills-and-evaluations.md", "url": "/.well-known/agent-skills/configuration/references/agent-skills-and-evaluations.md", "digest": "sha256:7119789b10dababc3c012ccd3d86d1e656859593e92dba47b4bf1078ff32d7eb" }, { "path": "references/core-options.md", "url": "/.well-known/agent-skills/configuration/references/core-options.md", "digest": "sha256:a7d535fd7678801a8aa8e8882000de01e3aac809d9335aa9456dbb9c58e2a032" }, { "path": "references/mcp-and-api-reference.md", "url": "/.well-known/agent-skills/configuration/references/mcp-and-api-reference.md", "digest": "sha256:77e25de801a5ead640a360ba6a30b9025bff63132261dc08aa8390cf683b2101" }, { "path": "references/search-and-feedback.md", "url": "/.well-known/agent-skills/configuration/references/search-and-feedback.md", "digest": "sha256:2798eab1f3909772c805224ca3403350972ec5f89b0879caaeb3b73004e2c385" } ] }, { "name": "creating-themes", "description": "Create and share a custom theme for @farming-labs/docs. Use when building a theme with createTheme(), extendTheme(), cherry-picking built-in defaults, publishing as npm package, or adding CSS overrides. Covers ui.colors, typography, layout, sidebar, radius, ui.components like HoverLink, and package layout for publishing.", "type": "skill-md", "url": "/.well-known/agent-skills/creating-themes/SKILL.md", "digest": "sha256:1131f61bea0d6136b8e0d115ec3618ed47bd45441b23659abeee232bd6ea5d24", "files": [ { "path": "SKILL.md", "url": "/.well-known/agent-skills/creating-themes/SKILL.md", "digest": "sha256:1131f61bea0d6136b8e0d115ec3618ed47bd45441b23659abeee232bd6ea5d24" } ] }, { "name": "getting-started", "description": "Get started with @farming-labs/docs — MDX-based documentation for Next.js, TanStack Start, Farm.js, SvelteKit, Astro, and Nuxt. Use when setting up docs, scaffolding with the CLI, choosing themes, changelog, API reference, or writing docs.config. Covers init, manual setup per framework, theme CSS, defineDocs, changelog, apiReference, entry, contentDir, and common gotchas.", "type": "archive", "url": "/.well-known/agent-skills/getting-started.tar.gz", "digest": "sha256:fb91ba37d67f1156f2ec730c288c07b24dd1f56c0bb7f9329bc75c8fa5005dda", "files": [ { "path": "SKILL.md", "url": "/.well-known/agent-skills/getting-started/SKILL.md", "digest": "sha256:55a834e800f3cd21c338bf2fbd23f9f4b31e865e1734f973fc301fb52f438aef" }, { "path": "references/api-reference.md", "url": "/.well-known/agent-skills/getting-started/references/api-reference.md", "digest": "sha256:2e71c13d15ed92178f0be4c9813c9de8e55a659a32c7d2fcde30f1a10aa6c991" }, { "path": "references/changelog.md", "url": "/.well-known/agent-skills/getting-started/references/changelog.md", "digest": "sha256:63105737c7d27d406da336976189386a7226c28e51a24b1403749e17e6abf702" } ] }, { "name": "page-actions", "description": "Configure @farming-labs/docs page actions for Copy Markdown, Open in LLM, one-click MCP connection, and Agent Skills installation. Use for copyMarkdown, openDocs, connectMcp, installSkills, providers, prompts, alignment, or position.", "type": "skill-md", "url": "/.well-known/agent-skills/page-actions/SKILL.md", "digest": "sha256:5f3b35ffabd75daa84f33a220991e2dfa30b02c998b7d16b361a2b77e2a6f98f", "files": [ { "path": "SKILL.md", "url": "/.well-known/agent-skills/page-actions/SKILL.md", "digest": "sha256:5f3b35ffabd75daa84f33a220991e2dfa30b02c998b7d16b361a2b77e2a6f98f" } ] } ], "recommended": [ { "name": "getting-started", "description": "Use for installation, init, framework setup, theme CSS, and first docs.config wiring." } ] }, "mcp": { "enabled": true, "endpoint": "/api/docs/mcp", "defaultEndpoint": "/mcp", "publicEndpoint": "/mcp", "wellKnownEndpoint": "/.well-known/mcp", "publicEndpoints": [ "/mcp", "/.well-known/mcp" ], "canonicalEndpoint": "/api/docs/mcp", "name": "@farming-labs/docs", "version": "0.2.121", "tools": { "listDocs": true, "listPages": true, "listPageSections": true, "readPage": true, "readPages": true, "submitFeedback": true, "listTasks": true, "readTask": true, "searchDocs": true, "searchFacets": true, "listContentChanges": true, "hydrateContentChanges": true, "getNavigation": true, "getCodeExamples": true, "getConfigSchema": true, "getContext": true, "getTrustMetadata": true }, "prompts": { "enabled": true, "contracts": true, "goldenTasks": [ "install-existing-nextjs", "create-reusable-theme" ] } }, "feedback": { "enabled": true, "schema": "/api/docs?feedback=agent&schema=1", "submit": "/api/docs?feedback=agent", "schemaQuery": "/api/docs?feedback=agent&schema=1", "submitQuery": "/api/docs?feedback=agent" }, "instructions": { "preferMarkdownRoutes": true, "useMcpWhenAvailable": true, "useOpenApiWhenAvailable": true, "readFeedbackSchemaBeforeSubmitting": true, "doNotAssumeFeedbackPayloadShape": true } }