doc-lister

List and filter documentation files by frontmatter metadata into structured JSON.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/fractary/claude-plugins --skill doc-lister
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: doc-lister
Source: https://github.com/fractary/claude-plugins/tree/main/plugins/docs/skills/doc-lister
Command: npx skills add https://github.com/fractary/claude-plugins --skill doc-lister

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bash, jq, and includes scripts (resource) components.

What problem does it solve?

Lists and filters documentation files by type, status, tags, and date-range using frontmatter metadata.

Core Features & Use Cases

  • Filter by doc_type, status, tags, date range
  • Return structured JSON of documents
  • Non-destructive, read-only discovery

Quick Start

List all documentation of type api published status.

Frequently Asked Questions about doc-lister

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I filter documentation files by type and status using frontmatter metadata?▼

Filter documentation files by frontmatter metadata using doc_type, status, tags, and date_range parameters. The Skill scans README.md files recursively, parses YAML frontmatter, applies your filters, and returns structured JSON without modifying source files.

Can I list documentation across multiple directories and parse YAML frontmatter automatically?▼

Yes. The Skill performs recursive directory traversal to discover README.md files, automatically parses YAML frontmatter from each file, and returns a consolidated JSON list of all matched documents with their metadata extracted.

What's the best way to organize and discover documentation by type, status, and tags?▼

Structure your documentation with YAML frontmatter containing doc_type, status, and tags fields. Use this Skill to query across your repository, filtering by these metadata fields to surface relevant docs without manual searching.

Does this work for read-only documentation discovery without modifying files?▼

Yes. The Skill is non-destructive and read-only, scanning and filtering your documentation files to return structured results without altering any source content.

Can I filter documentation by date range in addition to type and status?▼

Yes. The Skill supports filtering by date_range alongside doc_type, status, and tags, allowing you to discover documentation within specific time windows by parsing frontmatter dates.

What dependencies do I need to run documentation filtering and parsing?▼

You need bash for script execution and jq for JSON processing. These dependencies enable the Skill to traverse directories, parse YAML frontmatter, apply filters, and output structured results.