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.