doc-lister

fractary 的头像作者 fractary

按类型、状态、标签和日期范围列出和筛选文档文件,并解析前置元数据(frontmatter)

📖 中文导读:按类型、状态、标签和日期范围列出和筛选文档文件,并解析前置元数据(frontmatter) 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: doc-lister description: Lists and filters documentation files by type, status, tags, and date range with frontmatter parsing model: claude-haiku-4-5

doc-lister

**Purpose**: List and filter documentation files.

Architecture: Operation-specific skill (Layer 3)

- ALWAYS scan specified directory - ALWAYS parse frontmatter for filtering - NEVER modify files - ALWAYS return structured list Required: - `path` - Directory to scan (default: docs/)

Optional filters:

  • doc_type - Filter by fractary_doc_type
  • status - Filter by status (draft, published, deprecated)
  • tags - Filter by tags (array)
  • date_range - Filter by created/updated dates
1. **Scan Directory** - Find all README.md files recursively - Exclude node_modules, .git, etc.
  1. Parse Frontmatter

    • Extract YAML frontmatter from each file
    • Build document list with metadata
  2. Apply Filters

    • Filter by doc_type if specified
    • Filter by status if specified
    • Filter by tags if specified
    • Filter by date range if specified
  3. Return List

{
  "total": 42,
  "filtered": 15,
  "documents": [
    {
      "path": "docs/api/auth/login/README.md",
      "title": "Login Endpoint",
      "doc_type": "api",
      "status": "published",
      "version": "1.2.0",
      "updated": "2025-01-15"
    }
  ]
}