Fix Skill needs setup
How to resolve Skill needs setup warnings in a Reia skill document.
Written By Reia
Last updated About 1 hour ago
Skill needs setup means Reia can see the skill document, but the document is missing something required before it can guide Agent work.
Open the skill document and read the warning shown above the editor. Most setup issues come from a missing setup section, a missing name, a name that is not lowercase and hyphenated, a placeholder description, or empty instructions below the setup section.
A ready skill has a setup section with name and description, then clear instructions below it:
---name: diligence-questionsdescription: Use this when preparing diligence questions from reviewed deal materials.---Review the processed files and current underwriting context.Draft concise diligence questions grouped by owner.Flag any question that depends on an unavailable source.After editing, save the document and reopen /skills in Agent chat. If the warning remains, simplify the setup section first, then add the workflow instructions back below it.