# Vitepress Bilingual Page

> How to add a page to the tdmcp VitePress docs site so it builds, gets a clean URL, and lands in the right nav — including the repo's partial-translation convention (only the artist guide is EN+PT; reference/legal pages are English). Use when authoring the privacy policy or any new docs page for tdmcp.

- **Type:** Skill
- **Install:** `agentstack add skill-hybridlabor-api-bdb-dev-optimized-agent-skills-vitepress-bilingual-page`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [hybridlabor-api](https://agentstack.voostack.com/s/hybridlabor-api)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [hybridlabor-api](https://github.com/hybridlabor-api)
- **Source:** https://github.com/hybridlabor-api/bdb-dev-optimized-agent-skills/tree/main/mcps/tdmcp/.claude/skills/vitepress-bilingual-page

## Install

```sh
agentstack add skill-hybridlabor-api-bdb-dev-optimized-agent-skills-vitepress-bilingual-page
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Adding a page to the tdmcp VitePress site

The site lives under `docs/`, config in `docs/.vitepress/config.ts`
(`base: "/tdmcp/"`, `cleanUrls: true`, deployed to
`https://pantani.github.io/tdmcp/`).

## i18n convention — read this before deciding paths

**Only the artist guide track is translated (EN + PT-BR).** Everything else is
English-only. The config encodes three nav groups:

- `artistGuide(base)` / `artistGuidePt` → `docs/guide/*.md` and
  `docs/pt/guide/*.md`. This is the **only** mirrored track.
- `devReference` → `docs/reference/*.md` (English only).
- `operations` → standalone pages like `docs/DEPLOYMENT.md`, `docs/ROADMAP.md`
  (English only), plus external GitHub links.

So a **privacy / legal page is NOT an artist-guide page.** It belongs as a
**standalone page**, English as the canonical version (legal text is fine in EN;
the form needs exactly one privacy URL). Add a PT mirror only if the spec asks —
do not force it just because the guide is bilingual.

## Recommended placement for the privacy policy

- File: `docs/privacy.md` → clean URL `https://pantani.github.io/tdmcp/privacy`.
- Frontmatter: give it a `title:` (used by `transformHead`) and consider
  `aside: false` for a legal page.
- Nav: add to the `operations` array in `config.ts`:
  `{ text: "Privacy", link: "/privacy" }`. (It's the legal/ops group, not the
  artist sidebar.) Put it near the end, before/after Changelog.
- If a PT version is wanted: `docs/pt/privacy.md` + a `{ text: "Privacidade",
  link: "/pt/privacy" }` entry in the PT-side nav config.

> The site uses `cleanUrls`, so link to `/privacy`, never `/privacy.html`. For a
> page that needs a non-default URL (like DEPLOYMENT→deployment) you'd add a
> `rewrites` entry — a lowercase `privacy.md` needs none.

## How to verify a page is wired correctly

1. The `.md` file exists at the path whose URL you put in the nav.
2. The nav entry's `link` matches the clean URL (no `.md`, no `.html`).
3. `npm run docs:build` passes — VitePress fails the build on dead internal
   links, so a typo'd nav link or a broken in-page link is caught here. This is
   the gate; always run it after adding a page.
4. Loopback URLs (`localhost`, `127.0.0.1`) in prose are ignored by the dead-link
   checker (see `ignoreDeadLinks`), so you can mention the bridge address freely.

## Voice / content

Match the existing docs voice — pull product framing from `docs/index.md` and
`docs/guide/what-is-tdmcp.md` rather than inventing new copy. Keep legal pages
plain and direct; artists are the audience, so avoid dense legalese.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [hybridlabor-api](https://github.com/hybridlabor-api)
- **Source:** [hybridlabor-api/bdb-dev-optimized-agent-skills](https://github.com/hybridlabor-api/bdb-dev-optimized-agent-skills)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-hybridlabor-api-bdb-dev-optimized-agent-skills-vitepress-bilingual-page
- Seller: https://agentstack.voostack.com/s/hybridlabor-api
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.