working-with-indexes

Manages Fianu indexes via the /entities/indexes API including preview, recompute lifecycle, and typed errors.

1|Updated Jun 11, 2026
One-click install
npx skills add https://github.com/fianulabs/fianu-skills --skill working-with-indexes-fianulabs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: working-with-indexes
Source: https://github.com/fianulabs/fianu-skills/tree/main/skills/working-with-indexes
Command: npx skills add https://github.com/fianulabs/fianu-skills --skill working-with-indexes-fianulabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Fianu indexes are CEL-defined asset scopes that policies and gates reference, but their API surface has non-obvious behaviors: draft previews take pagination in the request body rather than the query string, create/update responses are wrapped in an index envelope, and materialization is asynchronous with its own recompute states. This Skill documents the exact endpoints, filters, lifecycle states, and typed F_72xxx errors so agents call the API correctly the first time. ## Core Features & Use Cases - Read and write operations: List, get, create, patch, and soft-delete indexes via /entities/indexes, with filters for entity status, recompute status, asset type, and index type. - Dual preview paths: Compile-only preview for unsaved drafts (body-based pagination) versus worker-materialized member preview for saved indexes. - Compute lifecycle and error handling: Interpret current/stale/computing/error recompute states and typed errors like F_72006 (not found), F_72007 (archived), and F_72008 (recompute failure). - Use Case: When a gate references an index and returns F_72008, use this Skill to diagnose the recompute failure via the examine endpoint and determine whether the index is archived, stale, or misconfigured. ## Quick Start Use the working-with-indexes skill to list all stale Fianu indexes and preview the members of the production-repositories index.

Frequently Asked Questions about working-with-indexes

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

FAQPage Schema
How do I preview a Fianu index before saving it?▼

Preview an unsaved index by sending a POST to /entities/indexes/preview with the CEL expressions in the body. Pagination parameters page and limit must go in the request body, not the query string, or they are silently ignored.

How do I list and filter indexes in the Fianu API?▼

Send GET /entities/indexes with query filters for entityStatus, recomputeStatus, assetTypePath, indexType, and includeArchived. The endpoint returns paged results, and each index can be fetched individually by UUID or path via GET /entities/indexes/:key.

Why does Fianu index preview return the wrong page of results?▼

Draft preview pagination fails when page and limit are sent as query parameters instead of in the POST request body. The draft preview endpoint reads pagination only from the body, so query-string values are silently ignored.

What does the F_72008 error mean on a Fianu index?▼

F_72008 IndexRecomputeError is a 503 response meaning the index members could not be computed by the worker. Use GET /entities/indexes/:key/examine to inspect the failure detail and check the index's recomputeStatus.

Does deleting a Fianu index remove it permanently?▼

No, DELETE /entities/indexes/:key performs a soft delete that archives the index rather than removing it. Archived indexes can still be retrieved by passing includeArchived on list or get requests, and referencing one returns F_72007.