AgentSkillsCN

tfdc-module-search

使用 tfdc 在 Terraform 模块注册表中进行搜索。适用于需要通过关键词查找 Terraform 模块、发现特定用途的可用模块(例如 VPC、EKS、S3),或获取模块 ID 以配合 tfdc 模块获取功能时使用。

SKILL.md
--- frontmatter
name: tfdc-module-search
description: Search the Terraform module registry using tfdc. Use when you need to find Terraform modules by keyword, discover available modules for a specific purpose (e.g., VPC, EKS, S3), or get module IDs for use with tfdc module get.

tfdc module search

Search the Terraform module registry.

Usage

bash
tfdc module search -query <keyword> [-offset 0] [-limit 20] [-format text]

Flags

FlagRequiredDefaultDescription
-queryYesSearch query (e.g., vpc, eks, s3)
-offsetNo0Result offset for pagination
-limitNo20Max results
-formatNotextOutput format: text, json, markdown

Output fields

FieldDescription
module_idModule ID in namespace/name/provider/version format
nameModule name
descriptionModule description
downloadsDownload count
verifiedWhether the module is verified
published_atPublication timestamp

Examples

bash
# Search for VPC modules
tfdc module search -query vpc

# Search with JSON output
tfdc module search -query eks -format json

# Paginated search
tfdc module search -query s3 -offset 20 -limit 10

JSON output

json
{
  "items": [
    {
      "module_id": "terraform-aws-modules/vpc/aws/6.6.0",
      "name": "vpc",
      "description": "Terraform module to create AWS VPC resources",
      "downloads": 168103660,
      "verified": false,
      "published_at": "2026-01-08T19:16:31.278629Z"
    }
  ],
  "total": 1
}

Workflow

Use with tfdc module get to fetch full module details:

bash
# Search
tfdc module search -query vpc -format json | jq '.items[].module_id'

# Get details
tfdc module get -id terraform-aws-modules/vpc/aws/6.6.0