tokens&
For enterprises
Submit
Sign in
tokens&

Build better AI stacks, claim useful opportunities, and give AI infrastructure companies a source-labeled adoption readout they can trust.

For buildersFor enterprises

Product

  • For builders
  • Category rankings
  • Startup credits and perks
  • Agent Skills
  • Platform
  • Submit project, tool, product, or perk

Enterprise

  • Start free company workspace

Community

  • Community
  • Newsletter
  • Events
Xin

© 2026 tokensand, LLC. All rights reserved.

  • Terms
  • Privacy
  • Security
  • Data Processing
  • Status
Agent Skills/Terramate best practices
TerramateBackendSKILL.mdVerified source

Agent Skill

Terramate best practices

Use Terramate stacks, generation, orchestration, and drift-safe infrastructure workflows.

Install this skillView repository

Vendor-authored source · MIT license.

Raw SKILL.mdInstall the Tokens& Agent Pack

Skill specification

Declared by Terramate in the package front matter. Trigger conditions are what the coding agent matches on before it loads the skill.

View package fields
Terramate best practices SKILL.md front matter fields
Skill nameterramate-best-practices
Trigger conditionsTerramate CLI, Cloud, and Catalyst best practices and usage guides. This skill should be used when working with Terramate stacks, orchestration, code generation, Cloud integration, or Catalyst components and bundles.
Declared licenseMIT
Version1.0.0
Authorterramate

Install terramate-best-practices

In a terminal with Node.js, npm and Git, run the command for your agent. The Skills CLI installs the complete package directory, including referenced files within it. Review its install prompt, then start a new agent session. A skill package does not set up an MCP server connection.

Claude Code

.claude/skills/terramate-best-practices/SKILL.md

Project skills are committed with the repo. Use the user directory for a personal install across every project.

Project install

npx skills add 'https://github.com/terramate-io/agent-skills/tree/main/skills/terramate-best-practices' --skill 'terramate-best-practices' --agent 'claude-code'
Install for all projects instead

Personal install

npx skills add 'https://github.com/terramate-io/agent-skills/tree/main/skills/terramate-best-practices' --skill 'terramate-best-practices' --agent 'claude-code' --global

Codex

.agents/skills/terramate-best-practices/SKILL.md

Codex reads `.agents/skills/` as its primary location, which is also the cross-platform default other clients honour.

Project install

npx skills add 'https://github.com/terramate-io/agent-skills/tree/main/skills/terramate-best-practices' --skill 'terramate-best-practices' --agent 'codex'
Install for all projects instead

Personal install

npx skills add 'https://github.com/terramate-io/agent-skills/tree/main/skills/terramate-best-practices' --skill 'terramate-best-practices' --agent 'codex' --global

Cursor

.agents/skills/terramate-best-practices/SKILL.md

Cursor also loads `.agents/skills/`, `.claude/skills/`, and `.codex/skills/`, so one committed copy can serve several clients.

Project install

npx skills add 'https://github.com/terramate-io/agent-skills/tree/main/skills/terramate-best-practices' --skill 'terramate-best-practices' --agent 'cursor'
Install for all projects instead

Personal install

npx skills add 'https://github.com/terramate-io/agent-skills/tree/main/skills/terramate-best-practices' --skill 'terramate-best-practices' --agent 'cursor' --global

GitHub Copilot

.agents/skills/terramate-best-practices/SKILL.md

The Skills CLI uses the shared `.agents/skills/` directory for Copilot project installs.

Project install

npx skills add 'https://github.com/terramate-io/agent-skills/tree/main/skills/terramate-best-practices' --skill 'terramate-best-practices' --agent 'github-copilot'
Install for all projects instead

Personal install

npx skills add 'https://github.com/terramate-io/agent-skills/tree/main/skills/terramate-best-practices' --skill 'terramate-best-practices' --agent 'github-copilot' --global

SKILL.md

View raw source

Published by Terramate under MIT. Rendered from the package in github.com/terramate-io/agent-skills/tree/main/skills/terramate-best-practices.

Read full skill instructions

Terramate Best Practices

Comprehensive guide for Terramate CLI, Cloud, and Catalyst, maintained by Terramate. Contains best practices and usage patterns for stack management, orchestration, code generation, Cloud integration, and Catalyst components/bundles.

When to Apply

Reference these guidelines when:

  • Creating and organizing Terramate stacks
  • Orchestrating commands across multiple stacks
  • Using code generation to keep configurations DRY
  • Integrating with Terramate Cloud for observability
  • Creating Catalyst components and bundles
  • Setting up CI/CD workflows with Terramate
  • Managing stack dependencies and execution order

Rule Categories by Priority

PriorityCategoryImpactPrefix
1CLI FundamentalsCRITICALcli-
2CLI OrchestrationHIGHcli-orchestration-
3CLI Code GenerationHIGHcli-codegen-
4CLI ConfigurationMEDIUM-HIGHcli-config-
5Terramate CloudMEDIUM-HIGHcloud-
6Terramate CatalystMEDIUMcatalyst-

Quick Reference

1. CLI Fundamentals (CRITICAL)

  • cli-stack-structure - Organize stacks with clear directory structure
  • cli-stack-config - Configure stacks with proper stack blocks
  • cli-stack-metadata - Use metadata for stack identification and filtering

2. CLI Orchestration (HIGH)

  • cli-orchestration-run - Run commands across stacks efficiently
  • cli-orchestration-change-detection - Use change detection to limit execution scope
  • cli-orchestration-parallel - Leverage parallel execution for independent stacks
  • cli-orchestration-dependencies - Manage stack dependencies and execution order

3. CLI Code Generation (HIGH)

  • cli-codegen-hcl - Use generate_hcl for DRY Terraform code
  • cli-codegen-file - Use generate_file for file generation patterns
  • cli-codegen-provider - Generate provider configurations dynamically

4. CLI Configuration (MEDIUM-HIGH)

  • cli-config-globals - Use globals for shared configuration across stacks
  • cli-config-lets - Use lets for stack-local computed values
  • cli-config-metadata - Leverage metadata for stack information

5. Terramate Cloud (MEDIUM-HIGH)

  • cloud-integration - Set up Cloud connection and authentication
  • cloud-drift-management - Configure drift detection and reconciliation
  • cloud-observability - Use Cloud dashboard for stack visibility

6. Terramate Catalyst (MEDIUM)

  • catalyst-components - Create reusable component blueprints
  • catalyst-bundles - Define bundles for component composition
  • catalyst-instantiation - Instantiate bundles correctly

7. CI/CD Integration (MEDIUM)

  • cicd-github-actions - Set up GitHub Actions workflows
  • cicd-preview-workflows - Create preview workflows for PRs
  • cicd-deployment-workflows - Configure deployment automation

8. Advanced Patterns (LOW-MEDIUM)

  • advanced-workflows - Create complex multi-step workflows
  • advanced-codegen-patterns - Advanced code generation techniques

How to Use

Read individual rule files for detailed explanations and code examples:

rules/cli-stack-structure.md
rules/cli-orchestration-run.md
rules/cli-codegen-hcl.md
rules/cloud-integration.md
rules/catalyst-components.md

Each rule file contains:

  • Brief explanation of why it matters
  • Incorrect/anti-pattern example with explanation
  • Correct/best practice example with explanation
  • Additional context and references

Full Compiled Document

For the complete guide with all rules expanded: AGENTS.md

More Terramate Agent Skills

All Agent Skills

Terraform best practices

Review Terraform modules, state, plans, and delivery workflows before infrastructure changes ship.

Backend

7
CI/CD Integration
MEDIUM
cicd-
8Advanced PatternsLOW-MEDIUMadvanced-