doc-lister

fractary's avatarfrom fractary

Lists and filters documentation files by type, status, tags, and date range with frontmatter parsing

⭐1stars🔀0forks📁View on GitHub🕐Updated Dec 15, 2025
[Files and Documents]

When & Why to Use This Skill

The doc-lister skill is a specialized utility designed for automated documentation management and discovery. It enables Claude to programmatically scan directories, parse YAML frontmatter from Markdown files, and generate structured lists based on complex filters such as document status, tags, and date ranges. This skill is essential for maintaining large-scale knowledge bases and ensuring documentation consistency through metadata-driven analysis.

Use Cases

  • Documentation Auditing: Quickly identify all 'deprecated' or 'draft' documents within a large repository to prioritize content updates and maintenance.
  • Automated Knowledge Retrieval: Filter technical guides by specific tags (e.g., 'API', 'Security') to provide highly relevant context for complex coding or research tasks.
  • Content Velocity Tracking: Generate a list of documents created or updated within a specific date range to monitor documentation progress and automate the creation of changelogs.
  • Structural Analysis: Organize and view documentation hierarchies by filtering for specific document types, helping teams understand the coverage and gaps in their technical manuals.
namedoc-lister
descriptionLists and filters documentation files by type, status, tags, and date range with frontmatter parsing
modelclaude-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"
    }
  ]
}