fls-paragraph-ids

Enforce :dp: paragraph ID placement and generate IDs in FLS documents.

Updated Jan 30, 2026

Search Tags:#automation #documentation #coding-standards #lint #ids #fls #paragraph-ids

Ready to run

npx skills add https://github.com/PLeVasseur/opencode-project-agents --skill fls-paragraph-ids

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: fls-paragraph-ids
Source: https://github.com/PLeVasseur/opencode-project-agents/tree/main/fls/skills/fls-paragraph-ids
Command: npx skills add https://github.com/PLeVasseur/opencode-project-agents --skill fls-paragraph-ids

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Paragraph IDs are often misassigned or inconsistently generated across FLS documents, causing lint warnings and maintenance headaches.

Core Features & Use Cases

Enforce and validate the placement of :dp: IDs in paragraphs, list items, and first table cells.
Provide exceptions handling for index and changelog via lint_no_paragraph_ids.
Include a generation helper command ./generate-random-ids.py to produce IDs.

Quick Start

Run the ID lint and generation workflow on an FLS document to automatically align IDs.

Frequently Asked Questions about fls-paragraph-ids

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

FAQPage Schema

How do I fix FLS paragraph ID lint warnings?▼

FLS paragraph ID lint warnings are fixed by enforcing correct :dp: ID placement within paragraphs, list items, and first table cells. This process validates document structure and aligns IDs to eliminate maintenance errors.

How do I generate random paragraph IDs for FLS documents?▼

Generate random paragraph IDs for FLS documents by running the ./generate-random-ids.py helper command. This script produces compliant IDs and automatically aligns them within your content to prevent misassignment.

Where should :dp: paragraph IDs be placed in FLS content?▼

:dp: paragraph IDs must be placed directly within paragraphs, list items, and the first table cells of FLS content. Correct placement ensures structural compliance and prevents inconsistent ID generation across documents.

Can I exclude index and changelog files from paragraph ID lint rules?▼

Index and changelog files can be excluded from paragraph ID lint rules by applying the lint_no_paragraph_ids exception. This bypasses standard ID enforcement for specific documents where IDs are unnecessary.

Why are my FLS paragraph IDs inconsistently generated across documents?▼

FLS paragraph IDs become inconsistent when documents are restructured without enforcing standardized ID generation. Running an automated lint and generation workflow validates placements and aligns IDs to resolve misassignment.