{"id":33279817,"url":"https://github.com/testcontainers/claude-skills","last_synced_at":"2026-02-03T13:13:11.293Z","repository":{"id":324047637,"uuid":"1095739949","full_name":"testcontainers/claude-skills","owner":"testcontainers","description":"Public repository for the Claude Skills for Testcontainers","archived":false,"fork":false,"pushed_at":"2026-01-16T19:04:05.000Z","size":9405,"stargazers_count":9,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-17T04:52:40.598Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/testcontainers.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-13T13:06:45.000Z","updated_at":"2026-01-03T00:42:40.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/testcontainers/claude-skills","commit_stats":null,"previous_names":["testcontainers/claude-skills"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/testcontainers/claude-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testcontainers%2Fclaude-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testcontainers%2Fclaude-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testcontainers%2Fclaude-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testcontainers%2Fclaude-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/testcontainers","download_url":"https://codeload.github.com/testcontainers/claude-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testcontainers%2Fclaude-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29046503,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-03T10:09:22.136Z","status":"ssl_error","status_checked_at":"2026-02-03T10:09:16.814Z","response_time":96,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-11-17T11:00:34.118Z","updated_at":"2026-02-03T13:13:11.275Z","avatar_url":"https://github.com/testcontainers.png","language":"Go","funding_links":[],"categories":["Testcontainers and AI/LLM"],"sub_categories":[],"readme":"# Testcontainers Skills for Claude\n\nSkills are folders of instructions, scripts, and resources that Claude loads dynamically to improve performance on specialized tasks. This repository contains Testcontainers-related skills that teach Claude how to work with container-based testing and infrastructure.\n\nFor more information about skills, check out:\n- [What are skills?](https://support.claude.com/en/articles/12512176-what-are-skills)\n- [Using skills in Claude](https://support.claude.com/en/articles/12512180-using-skills-in-claude)\n- [How to create custom skills](https://support.claude.com/en/articles/12512198-creating-custom-skills)\n- [Equipping agents for the real world with Agent Skills](https://anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills)\n- [Main skills repository](https://github.com/anthropics/skills) - Upstream repository with example skills\n\n## About This Repository\n\nThis repository contains Testcontainers-related skills for Claude. These skills help Claude work more effectively with container-based testing infrastructure, particularly focusing on integration testing patterns using Docker containers.\n\nEach skill is self-contained in its own directory with a `SKILL.md` file containing the instructions and metadata that Claude uses.\n\nThe skills in this repository are open source under the MIT License.\n\n## Disclaimer\n\n**These skills are provided for demonstration and educational purposes only.** While some of these capabilities may be available in Claude, the implementations and behaviors you receive from Claude may differ from what is shown in these examples. These examples are meant to illustrate patterns and possibilities. Always test skills thoroughly in your own environment before relying on them for critical tasks.\n\n## Available Skills\n\n### testcontainers-go\nA comprehensive guide for using Testcontainers for Go to write reliable integration tests with Docker containers in Go projects. This skill provides:\n\n- Support for 62+ pre-configured modules for databases, message queues, cloud services, and more\n- Best practices for setting up and managing Docker containers in Go tests\n- Configuration guidance for networking, volumes, and environment variables\n- Proper cleanup and resource management patterns\n- Debugging and troubleshooting techniques\n\n**Key capabilities:**\n- Use pre-configured modules (PostgreSQL, Redis, Kafka, MySQL, MongoDB, and more)\n- Write integration tests with real services instead of mocks\n- Test against multiple versions or configurations of dependencies\n- Create reproducible test environments\n- Set up ephemeral test infrastructure\n\nSee the [testcontainers-go skill documentation](./testcontainers-go/SKILL.md) for detailed usage instructions and examples.\n\n## Try in Claude Code, Claude.ai, and the API\n\n### Claude Code\nYou can register this repository as a Claude Code Plugin marketplace by running the following command in Claude Code:\n```\n/plugin marketplace add testcontainers/claude-skills\n```\n\nThen, to install the testcontainers-go skill:\n1. Select `Browse and install plugins`\n2. Select `testcontainers-claude-skills`\n3. Select `testcontainers-go`\n4. Select `Install now`\n\nAlternatively, directly install the plugin via:\n```\n/plugin install testcontainers-go@testcontainers-claude-skills\n```\n\nAfter installing the plugin, you can use the skill by just mentioning it. For instance: \"Use the testcontainers-go skill to help me write an integration test for PostgreSQL\"\n\n### Claude.ai\n\nTo use any skill from this repository or upload custom skills, follow the instructions in [Using skills in Claude](https://support.claude.com/en/articles/12512180-using-skills-in-claude#h_a4222fa77b).\n\n### Claude API\n\nYou can upload custom skills via the Claude API. See the [Skills API Quickstart](https://docs.claude.com/en/api/skills-guide#creating-a-skill) for more.\n\n## Creating a Basic Skill\n\nSkills are simple to create - just a folder with a `SKILL.md` file containing YAML frontmatter and instructions. Here's a basic template:\n\n```markdown\n---\nname: my-skill-name\ndescription: A clear description of what this skill does and when to use it\nlicense: MIT\n---\n\n# My Skill Name\n\n[Add your instructions here that Claude will follow when this skill is active]\n\n## Description\n\nDetailed explanation of the skill's capabilities.\n\n## When to Use This Skill\n\n- Use case 1\n- Use case 2\n- Use case 3\n\n## Instructions\n\nStep-by-step guidance on how to use the skill.\n\n## Examples\n\nExample code and usage patterns.\n\n## Best Practices\n\nGuidelines and recommendations.\n```\n\nThe frontmatter requires:\n- `name` - A unique identifier for your skill (lowercase, hyphens for spaces)\n- `description` - A complete description of what the skill does and when to use it\n- `license` - (Optional) License for the skill content\n\nThe markdown content below contains the instructions, examples, and guidelines that Claude will follow. For more details, see [How to create custom skills](https://support.claude.com/en/articles/12512198-creating-custom-skills).\n\n## Contributing\n\nContributions are welcome! If you have a Testcontainers-related skill that would benefit the community:\n\n1. Fork this repository\n2. Create a new directory for your skill\n3. Add a `SKILL.md` file with proper frontmatter and instructions\n4. Submit a pull request with a clear description of the skill\n\nPlease ensure your skill:\n- Follows the structure and format of existing skills\n- Includes clear documentation and examples\n- Is specific to Testcontainers or container-based testing\n- Is licensed under MIT or a compatible open source license\n\n## License\n\nThis repository is licensed under the MIT License. See the [LICENSE](./LICENSE) file for details.\n\n## Related Projects\n\n- [Testcontainers for Go](https://github.com/testcontainers/testcontainers-go) - The main Testcontainers for Go library\n- [Testcontainers](https://testcontainers.com/) - Official Testcontainers website\n- [Anthropic Skills](https://github.com/anthropics/skills) - Main skills repository with additional examples\n\n## Acknowledgments\n\nThis repository is inspired by and follows the structure of the [Anthropic Skills repository](https://github.com/anthropics/skills). The testcontainers-go skill was originally contributed to the main skills repository in [PR #73](https://github.com/anthropics/skills/pull/73) and is maintained here as a Testcontainers-focused collection.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftestcontainers%2Fclaude-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftestcontainers%2Fclaude-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftestcontainers%2Fclaude-skills/lists"}