Skills for authoring Topo Templates

If you already have a Docker Compose project and want to convert it to a Topo Template, you can do so with an Agent Skill. You can also use a skill to create your own Topo Template from scratch. These skills are optional authoring aids.

The Topo Template Format Specification currently provides the following skills:

  • topo-template-context: provides Topo and Topo Template reference context for questions about x-topo metadata, schema, docs, and CLI template behavior.
  • topo-template-bootstrap: converts a repository into a Topo Template by adding or improving compose.yaml and x-topo metadata.
  • topo-template-lint: reviews an existing Topo Template for correctness, consistency, and authoring best practices.

For the most up-to-date list of the available Topo Template skills, see Topo Skills .

Install the skills

Install the Topo Template skills with npx skills :

Note

npx requires Node.js. If you don’t have Node.js installed on your machine, install it before running the following command.

    

        
        
npx skills add arm/topo-template-format --all --yes

    

Restart your AI coding agent after installing or updating skills to make sure new skills are loaded for use.

Use the skills

After installing skills, you can prompt your agent to use a skill.

For example, to create a Topo Template from an existing project:

    

        
        
Use the topo-template-bootstrap skill to convert this repository into a Topo Template.

    

What you’ve accomplished

You’ve now learned how you can install and use Agent Skills to help author Topo Templates.

You can now create, modify, and deploy Topo Templates to Arm-based Linux targets. To find more templates to clone and modify, explore the Topo Catalog .

Back
Next