skills.rest
PLeVasseur
PLeVasseurCOMMUNITY
Explore all skills by this author →
Website𝕏@AwkwardMapGitHub

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
One-click install
npx skills add https://github.com/PLeVasseur/opencode-project-agents --skill fls-paragraph-ids
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
OpenRaiserOpenRaiser
334

Overflow Repair Skill

Fix LaTeX Overfull \hbox defects with minimal .tex source edits.

Official
Intermediate
attasecattasec
33

tmdd-threat-modeling

Generate code-grounded YAML threat models with lint-validated outputs.

Official
Advanced
NolanPicNolanPic

Global Commenting

Enforce global commenting standards across codebases and files.

Community
Basic
hwj123hwjhwj123hwj
4

scaffold-exercises

Generate coding exercise directory structures with sections, problems, solutions, and explainers.

Community
Basic