scaffold-list-query

Scaffold a paged, filterable List Query endpoint using MapGet and ToPagedListAsync.

15|Updated Dec 25, 2025
One-click install
npx skills add https://github.com/aalmada/BookStore --skill scaffold-list-query
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scaffold-list-query
Source: https://github.com/aalmada/BookStore/tree/main/.claude/skills/scaffold-list-query
Command: npx skills add https://github.com/aalmada/BookStore --skill scaffold-list-query

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill scaffolds a List Query endpoint to fetch a paged, filterable collection of resources, reducing boilerplate and ensuring consistent paging behavior.

Core Features & Use Cases

  • Paged Queries: generate endpoints that return a paged list of resources with optional filters.
  • Caching: integrate caching to improve performance for repeated queries.
  • Use Case: imagine listing books with filters for genre and author, returning results in pages.

Quick Start

Use scaffold-list-query to generate a List endpoint that returns a paged, filtered list of resources.

Frequently Asked Questions about scaffold-list-query

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

FAQPage Schema
How do I scaffold a paged and filterable list query endpoint in ASP.NET?

To scaffold a paged list query endpoint, this Skill generates a MapGet endpoint that applies resource filters and uses ToPagedListAsync to return a paginated collection, reducing boilerplate.

Can I integrate caching into my ASP.NET API list query endpoints?

Yes, this Skill integrates caching into your list query endpoints by utilizing the GetOrCreateLocalizedAsync pattern, which improves performance for repeated paged resource queries.

What is the best way to implement paged queries for resources using Marten?

The best way to implement paged queries is using this Skill to generate a filterable endpoint that queries Marten, applies Where clauses, and returns results via ToPagedListAsync.

Does this list query scaffolding tool work without external dependencies?

Yes, this list query scaffolding tool works without external dependencies, using an internal ListEndpoint.cs template to generate the MapGet endpoint pattern for your API services.

How do I add filtering to a paged list of resources in my API?

You add filtering by generating a list query endpoint that accepts optional filters, applies them via Where clauses, and returns the matched resources in a paginated list.

Why should I use a scaffolding tool for paged list queries?

You should use a scaffolding tool for paged list queries to ensure consistent paging and caching behavior across your API services while significantly reducing repetitive boilerplate code.