flowai-skill-engineer-skill

To create a SKILL.md file, populate the required frontmatter fields (name and description) and include optional resources like scripts, references, or assets to support modular skill packaging. Place the directory under .claude/skills.

The required frontmatter for packaging Agent Skills includes a clear name and description. Optional resources such as scripts, references, and assets can be added to enhance the skill's functionality and ensure reliable activation.

Yes, Agent Skills are designed for cross-IDE compatibility. Following best practices for concise descriptions and proper file structuring ensures your SKILL.md packages remain discoverable and reliably activate across different development environments.

You validate an Agent Skill package by checking its SKILL.md frontmatter for required fields and verifying that optional resources (scripts, references, assets) are properly structured to ensure repeatable, modular skill packaging and reliable activation.

The best way to structure directories for skill creation is to create a dedicated skill directory under .claude/skills, add a SKILL.md file with required frontmatter, and organize supporting scripts, references, and assets modularly.

Agent Skills may fail to activate correctly if the SKILL.md frontmatter lacks required fields, descriptions are vague, or file structures are improperly organized, preventing the IDE from discovering and reliably triggering the skill.