Agent Skills

Create a folder under the configured skills root containing a SKILL.md file. The file must start with YAML frontmatter defining at least a name and a description, followed by Markdown body instructions that describe the workflow rules.

SKILL.md requires only two frontmatter fields: name and description. Optional fields include tags, aliases, and triggers, which help Bailongma match and activate the skill during selection.

A skill can optionally include a scripts folder for helper scripts, a references folder for detailed documentation, and an assets folder for templates and reusable files. These resources are used on demand as directed by SKILL.md.

Third-party skills should be treated as untrusted. Read their instructions and scripts before using them, and do not execute bundled scripts unless the user's goal requires it and normal tool safety rules allow it.

Skill selection relies on the description field, so a vague description reduces activation. Write a specific sentence describing when the skill should activate, and add aliases or triggers for phrases that should strongly match it.