a6590072

Yuque

Knowledgev1.0.0
By a6590072Updated 2026-05-11yuque@clawhub_a6590072/yuque
Knowledge Base Q&AInformation OrganizingDocument Q&A#Knowledge Base#Document#Personal

According to AlphaMoat, as of 2026-09, Yuque has 1,094 downloads and 0 stars — ranked #4,984 of 5,078 AI skills overall, and #435 of 442 in Knowledge.

Installs
134
Downloads
1.1K
Stars
-
Overall Rank
#4,984
Top 99% overall · Top 99% in Knowledge
PlatformInstallsDownloadsStarsComments
ClawHub ↗271.0K--
SkillHub ↗1341.1K-—

Platforms count differently and update at different times.

What this skill does

The skill can list repositories, search and read documents, and create or update content. It requires a Yuque token that may access personal or team knowledge bases.

Profile published 2026-10-29

What you can do with it

  • For users who need an agent workflow to find or manage Yuque documents and knowledge bases.

When to use it

  • Store the token in a protected environment or secret manager. Confirm the exact operation and target repository before creating, updating, or deleting documents.

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

Find Yuque documents related to project planning and summarize them without creating, changing, or deleting anything.

Monthly Trend

Downloads1.1K
2196891.2K2026-03 · Downloads 2842026-05 · Downloads 6242026-06 · Downloads 7272026-07 · Downloads 9072026-08 · Downloads 9702026-09 · Downloads 1.1K26-0326-09
Stars-
0112026-03 · Stars -2026-05 · Stars -2026-06 · Stars -2026-07 · Stars -2026-08 · Stars -2026-09 · Stars -26-0326-09

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change. Other skills share this name; figures from before the change are attributed to this one, which currently has the most downloads.

MonthDownloadsMoMStars
2026-091.1K—-
2026-08970+6.9%-
2026-07907+24.8%-
2026-06727+16.5%-
2026-05624—-
2026-03284—-

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

3.0 KB · ClawHub v1.0.0
---
name: yuque
description: Manage Yuque (语雀) knowledge base documents and repositories. Use when users need to interact with Yuque for document operations including reading documents, listing repositories, searching content, creating documents, and managing knowledge bases. Supports both personal and team spaces.
---

# Yuque Skill

Interact with Yuque (语雀) knowledge base platform via the Yuque Open API.

## Prerequisites
Show all (120 lines)

- Yuque API Token (stored in environment variable `YUQUE_TOKEN`)
- Base URL: `https://www.yuque.com/api/v2`

## Authentication

All API requests require an `X-Auth-Token` header with your Yuque token.

## Core Workflows

### 1. Get User Info

```bash
curl -s -H "X-Auth-Token: $YUQUE_TOKEN" https://www.yuque.com/api/v2/user
```

### 2. List User Repositories

```bash
curl -s -H "X-Auth-Token: $YUQUE_TOKEN" https://www.yuque.com/api/v2/users/<login>/repos
```

### 3. List Repository Documents

```bash
curl -s -H "X-Auth-Token: $YUQUE_TOKEN" https://www.yuque.com/api/v2/repos/<namespace>/docs
```

### 4. Get Document Detail

```bash
curl -s -H "X-Auth-Token: $YUQUE_TOKEN" https://www.yuque.com/api/v2/repos/<namespace>/docs/<slug>
```

### 5. Get Document Content (HTML/Markdown)

```bash
# Get HTML content
curl -s -H "X-Auth-Token: $YUQUE_TOKEN" https://www.yuque.com/api/v2/repos/<namespace>/docs/<slug>?raw=1

# Get Markdown content
curl -s -H "X-Auth-Token: $YUQUE_TOKEN" https://www.yuque.com/api/v2/repos/<namespace>/docs/<slug>?raw=1 | python scripts/parse_yuque.py --format md
```

### 6. Create Document

```bash
curl -s -X POST \
  -H "X-Auth-Token: $YUQUE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "Document Title", "body": "Document content in Markdown"}' \
  https://www.yuque.com/api/v2/repos/<namespace>/docs
```

### 7. Update Document

```bash
curl -s -X PUT \
  -H "X-Auth-Token: $YUQUE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "New Title", "body": "Updated content"}' \
  https://www.yuque.com/api/v2/repos/<namespace>/docs/<id>
```

### 8. Search Documents

Yuque API doesn't have a direct search endpoint. Use list + filter approach:

```bash
# List all docs in a repo and filter by title
python scripts/search_yuque.py --namespace <namespace> --query "keyword"
```

## Common Namespace Formats

- Personal repo: `username/repo-slug`
- Team repo: `teamname/repo-slug`

## Response Format

All API responses are JSON with this structure:

```json
{
  "data": { ... },
  "meta": { ... }
}
```

## Error Handling

Common HTTP status codes:
- `401`: Unauthorized (check token)
- `403`: Forbidden (no permission)
- `404`: Resource not found
- `429`: Rate limited (wait and retry)

## Helper Scripts

Use the provided Python scripts for common operations:

- `scripts/yuque_cli.py` - Full CLI for Yuque operations
- `scripts/parse_yuque.py` - Parse Yuque HTML to Markdown
- `scripts/search_yuque.py` - Search documents in repositories

## References

- API Documentation: See [references/api.md](references/api.md)
- Common Operations: See [references/examples.md](references/examples.md)

Popular in Knowledge

Data month: 2026-09 · Downloads, stars and installs are aggregated monthly from public skill registries (ClawHub, SkillHub). See methodology.