adopters

Create or update ADOPTERS.md files for CNCF projects.

2|Updated Mar 4, 2026

Search Tags:#documentation #community #graduation #cncf #adopters #project maturity

Ready to run

npx skills add https://github.com/castrojo/cncf-skills --skill adopters

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: adopters
Source: https://github.com/castrojo/cncf-skills/tree/main/skills/adopters
Command: npx skills add https://github.com/castrojo/cncf-skills --skill adopters

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps CNCF projects document organizations using their software in production, a key requirement for project maturity and graduation.

Core Features & Use Cases

Create/Update ADOPTERS.md: Generates or maintains the ADOPTERS.md file.
Production User Tracking: Distinguishes between end-users and vendors, crucial for graduation criteria.
Self-Reporting Mechanism: Sets up an issue template for adopters to easily add themselves.
Use Case: An incubating CNCF project needs to demonstrate at least three independent production end-users to graduate. This Skill guides the maintainers through creating and populating the ADOPTERS.md file, ensuring all CNCF requirements are met.

Quick Start

Use the adopters skill to create or update the ADOPTERS.md file for the project.

Frequently Asked Questions about adopters

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I document project adopters for CNCF graduation requirements?▼

Document project adopters by creating or updating an ADOPTERS.md file to track organizations using your CNCF project in production. This process guides maintainers through seeding known adopters and distinguishing end-users from vendors to meet maturity criteria.

What is the difference between end-users and vendors for CNCF project maturity?▼

For CNCF project maturity, end-users are organizations adopting the software in production, while vendors provide related services. Distinguishing them is crucial because graduation criteria require demonstrating independent production end-users rather than vendor partnerships.

How do I set up a self-reporting process for adopters in a CNCF project?▼

Set up a self-reporting process for adopters by establishing an issue template within your repository. This allows organizations using your project in production to easily submit their information and add themselves to the ADOPTERS.md file.

Do I need an ADOPTERS.md file to graduate from CNCF incubating status?▼

Yes, an ADOPTERS.md file is needed to demonstrate production usage for CNCF graduation. Incubating projects must show at least three independent production end-users, and maintaining this documentation provides the required evidence for maturity evaluation.

What's the best way to track organizations using my open source project in production?▼

Track organizations using your open source project by maintaining a dedicated ADOPTERS.md file. This approach standardizes documentation, distinguishes end-users from vendors, and sets up issue templates for self-reporting to ensure records remain current.