Skip to content

README.md

Latest commit

 

History

History
102 lines (69 loc) · 4.47 KB

README.md

File metadata and controls

102 lines (69 loc) · 4.47 KB
Raw

Farming Labs — Agent Skills for @farming-labs/docs

This folder contains Agent Skills (conforming to the Agent Skills specification) for @farming-labs/docs — an MDX-based documentation framework for Next.js, TanStack Start, SvelteKit, Astro, and Nuxt.

Each skill is a separate directory with a SKILL.md file. Use the skill that matches the task (getting started, CLI, creating themes, Ask AI, page actions, or configuration, including search adapters, changelog setup, API reference, and MCP).

The repo also includes a runnable Next example for testing MCP plus external search providers:

pnpm --dir examples/next dev

Useful routes:

  • MCP: http://127.0.0.1:3000/api/docs/mcp
  • Search API: http://127.0.0.1:3000/api/docs?query=session

Available skills

Skill Path When to use
Getting started getting-started Setting up docs, init, manual install, theme CSS, docs.config, packages by framework, generated changelog pages in Next.js, and API reference wiring from local routes or a hosted OpenAPI JSON.
CLI cli Scaffolding and commands: init flow (existing vs fresh), Create your own theme, optional defaults (Enter to accept), init / upgrade / mcp, --template, --name, --theme, --entry, --api-reference, --framework, --config, package manager commands.
Creating themes creating-themes Building a custom theme with createTheme(), extendTheme(), ui.components defaults like HoverLink, publishing as npm, CSS overrides.
Ask AI ask-ai Enabling and configuring the RAG-powered AI chat: mode, floatingStyle, providers, models, suggestedQuestions, apiKey.
Page actions page-actions Copy Markdown and Open in LLM buttons: copyMarkdown, openDocs, providers, urlTemplate, position, alignment, and provider defaults.
Configuration configuration docs.config.ts options: entry, theme, staticExport, sidebar, breadcrumb, github, components, search, changelog, feedback, metadata, og, mcp, and apiReference including remote specUrl support.

Installing with Skills CLI (skills.sh)

From the Agent Skills Directory, add skills from this repo and pick your preferred skill(s) when prompted.

Install (use your preferred package manager):

# npm
npx skills add farming-labs/docs

# pnpm
pnpm dlx skills add farming-labs/docs

# yarn
yarn dlx skills add farming-labs/docs

# bun
bunx skills add farming-labs/docs

The CLI will list skills under skills/farming-labs/. Choose the one(s) you need (e.g. getting-started, cli, creating-themes, ask-ai, page-actions, configuration). You can install multiple skills or add more later.

Install a specific skill by path (if your CLI supports it):

pnpm dlx skills add farming-labs/docs/skills/farming-labs/getting-started
pnpm dlx skills add farming-labs/docs/skills/farming-labs/cli
pnpm dlx skills add farming-labs/docs/skills/farming-labs/creating-themes
pnpm dlx skills add farming-labs/docs/skills/farming-labs/ask-ai
pnpm dlx skills add farming-labs/docs/skills/farming-labs/page-actions
pnpm dlx skills add farming-labs/docs/skills/farming-labs/configuration

Cursor (project-level)

Copy the skill(s) you need into your project:

mkdir -p .cursor/skills
cp -r skills/farming-labs/getting-started .cursor/skills/
cp -r skills/farming-labs/cli .cursor/skills/
# ... repeat for creating-themes, ask-ai, page-actions, configuration

Or copy the whole farming-labs folder and let the agent use any of the skills:

mkdir -p .cursor/skills
cp -r skills/farming-labs/* .cursor/skills/

Validation

Skills follow the Agent Skills specification: each SKILL.md has required frontmatter (name, description) with name matching the parent directory. You can validate with skills-ref:

skills-ref validate ./skills/farming-labs/getting-started

Resources