creating-themes SKILL.md skillA

creating-themes from farming-labs/docs is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add farming-labs/docs/creating-themes@git:20260802.60f871a

Pins git:20260802.60f871a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
farming-labs/docs
Path
skills/farming-labs/creating-themes/SKILL.md
Versions recorded
5
Latest version
git:20260802.60f871a, committed Aug 2, 2026
First version recorded
May 16, 2026
Size
8,402 bytes
Repository stars
53
License
none declared

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.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# @farming-labs/docs — Creating and Sharing Themes

**Use this skill when:** the user wants to create a custom theme, extend an existing theme, or publish/share a theme (e.g. as npm). For general setup (init, install, docs.config), use the **getting-started** skill.

**Full guide:** [Creating your own theme](https://docs.farming-labs.dev/docs/themes/creating-themes).

---

## Quick: create a theme

```ts title="my-theme.ts"
import { createTheme } from "@farming-labs/docs";

export const myTheme = createTheme({
  name: "my-theme",
  ui: {
    colors: {
      primary: "#e11d48",
      background: "#09090b",
      foreground: "#fafafa",
      muted: "#71717a",
      border: "#27272a",
    },
    radius: "0.5rem",
  },
});
```

Use in `docs.config`:

```ts
import { defineDocs } from "@farming-labs/docs";
import { myTheme } from "./my-theme";

export default defineDocs({
  entry: "docs",
  theme: myTheme(),
});
```

Users can override: `theme: myTheme({ ui: { colors: { primary: "#3b82f6" } } })`.

---

## Copy prompt: match an existing website

Use this when a user wants docs that look like their main website.

```text
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add farming-labs/docs/creating-themes@sha256:1131f61bea0d6136

The line at the top of this page pins the label git:20260802.60f871a, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_j2x32sswwdaut2rc.svg)](https://markdownregistry.com/a/art_j2x32sswwdaut2rc)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between May 16, 2026 and Aug 2, 2026, about one every 20 days.

versioncommittedcommitsizeaudit
git:20260802.60f871a latest2026-08-02 60f871a 8,402 BA view · diff
git:20260801.728cb8b2026-08-01 728cb8b 8,382 BA view · diff
git:20260617.5b9d7a02026-06-17 5b9d7a0 8,196 BA view · diff
git:20260519.be470e32026-05-19 be470e3 8,216 BA view · diff
git:20260516.06445db2026-05-16 06445db 7,824 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (8402 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

farming-labs/docs · 53 stars · license none declared · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_j2x32sswwdaut2rc
GET https://markdownregistry.com/api/v1/resolve?ref=farming-labs/docs/creating-themes
GET https://markdownregistry.com/api/v1/blob/1131f61bea0d6136b8e0d115ec3618ed47bd45441b23659abeee232bd6ea5d24

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from farming-labs/docs

AGENTS.md AGENTS.md file
farming-labs/docs · AGENTS.md
git:20260805.0a10038 · audit A · 53 stars
llms.txt@benchmark/codex/mintlify llms.txt file
farming-labs/docs · benchmark/codex/mintlify/llms.txt
git:20260421.821dcfa · audit A · 53 stars
ask-ai SKILL.md skill
farming-labs/docs · examples/astro/.agents/skills/ask-ai/SKILL.md · Configure the Ask AI (RAG-powered AI chat) in @farming-labs/docs. Use when enabling AI chat, setting mode (search vs…
git:20260309.c3e6c67 · audit B · 53 stars
configuration SKILL.md skill
farming-labs/docs · examples/astro/.agents/skills/configuration/SKILL.md · docs.config.ts options for @farming-labs/docs. Use when configuring entry, contentDir, theme, staticExport, nav…
git:20260309.c3e6c67 · audit A · 53 stars
creating-themes SKILL.md skill
farming-labs/docs · examples/astro/.agents/skills/creating-themes/SKILL.md · Create and share a custom theme for @farming-labs/docs. Use when building a theme with createTheme(), extendTheme()…
git:20260309.c3e6c67 · audit A · 53 stars
farming-labs-docs SKILL.md skill
farming-labs/docs · examples/astro/.agents/skills/farming-labs-docs/SKILL.md · Get started with @farming-labs/docs — MDX-based documentation for Next.js, SvelteKit, Astro, and Nuxt. Use when setting…
git:20260309.c3e6c67 · audit A · 53 stars
getting-started SKILL.md skill
farming-labs/docs · examples/astro/.agents/skills/getting-started/SKILL.md · Get started with @farming-labs/docs — MDX-based documentation for Next.js, SvelteKit, Astro, and Nuxt. Use when setting…
git:20260309.c3e6c67 · audit A · 53 stars
page-actions SKILL.md skill
farming-labs/docs · examples/astro/.agents/skills/page-actions/SKILL.md · Configure page actions in @farming-labs/docs — Copy Markdown and Open in LLM buttons. Use when enabling copyMarkdown…
git:20260309.c3e6c67 · audit A · 53 stars
farming-labs-docs SKILL.md skill
farming-labs/docs · examples/next/.agents/skills/farming-labs-docs/SKILL.md · Get started with @farming-labs/docs — MDX-based documentation for Next.js, SvelteKit, Astro, and Nuxt. Use when setting…
git:20260309.a41c9b9 · audit A · 53 stars
ask-ai SKILL.md skill
farming-labs/docs · skills/farming-labs/ask-ai/SKILL.md · Configure the Ask AI (RAG-powered AI chat) in @farming-labs/docs. Use when enabling AI chat, setting mode (search vs…
git:20260801.728cb8b · audit B · 53 stars
cli SKILL.md skill
farming-labs/docs · skills/farming-labs/cli/SKILL.md · Use the @farming-labs/docs CLI to scaffold projects or Agent Skills, upgrade, downgrade, deploy, audit, compare OpenAPI…
git:20260930.95599f4 · audit A · 53 stars
configuration SKILL.md skill
farming-labs/docs · skills/farming-labs/configuration/SKILL.md · docs.config.ts options for @farming-labs/docs. Use when configuring entry, contentDir, theme, staticExport, navigation…
git:20260929.5d2067e · audit A · 53 stars

Every file in farming-labs/docs

Other files named creating-themes

creating-themes SKILL.md skill
farming-labs/docs · examples/astro/.agents/skills/creating-themes/SKILL.md · Create and share a custom theme for @farming-labs/docs. Use when building a theme with createTheme(), extendTheme()…
git:20260309.c3e6c67 · audit A · 53 stars

Browse by kind, by grade A, or by owner.