From 1a933fdf74769742e397b2755cfa2f1a2b744ac8 Mon Sep 17 00:00:00 2001
From: Greyson LaLonde <greyson@crewai.com>
Date: Mon, 16 Mar 2026 16:57:21 -0400
Subject: [PATCH] docs: remove references to unexported load_resources and
 disclosure level constants

---
 docs/en/concepts/skills.mdx    | 13 ++++++-------
 docs/ko/concepts/skills.mdx    | 13 ++++++-------
 docs/pt-BR/concepts/skills.mdx | 13 ++++++-------
 3 files changed, 18 insertions(+), 21 deletions(-)

diff --git a/docs/en/concepts/skills.mdx b/docs/en/concepts/skills.mdx
index f509c66ea..90a7f822d 100644
--- a/docs/en/concepts/skills.mdx
+++ b/docs/en/concepts/skills.mdx
@@ -102,15 +102,14 @@ agent = Agent(
 )
 ```
 
-## Disclosure Levels
+## How Skills Are Loaded
 
-Skills load progressively through three levels:
+Skills load progressively — only the data needed at each stage is read:
 
-| Level            | What's loaded                                     | When               |
+| Stage            | What's loaded                                     | When               |
 | :--------------- | :------------------------------------------------ | :----------------- |
-| `METADATA`       | Name, description, frontmatter fields             | `discover_skills()` |
-| `INSTRUCTIONS`   | Full SKILL.md body text                           | `activate_skill()` |
-| `RESOURCES`      | File listings from scripts/, references/, assets/ | `load_resources()` |
+| Discovery        | Name, description, frontmatter fields             | `discover_skills()` |
+| Activation       | Full SKILL.md body text                           | `activate_skill()` |
 
-During normal agent execution, skills are automatically discovered and activated (promoted to `INSTRUCTIONS`). Use `load_resources()` only when you need to inspect available files programmatically.
+During normal agent execution, skills are automatically discovered and activated. The `scripts/`, `references/`, and `assets/` directories are available on the skill's `path` for agents that need to reference files directly.
 
diff --git a/docs/ko/concepts/skills.mdx b/docs/ko/concepts/skills.mdx
index 1c2882005..a6361bce2 100644
--- a/docs/ko/concepts/skills.mdx
+++ b/docs/ko/concepts/skills.mdx
@@ -102,14 +102,13 @@ agent = Agent(
 )
 ```
 
-## 공개 레벨
+## 스킬 로드 방식
 
-스킬은 세 단계를 통해 점진적으로 로드됩니다:
+스킬은 점진적으로 로드됩니다 — 각 단계에서 필요한 데이터만 읽습니다:
 
-| 레벨              | 로드되는 내용                                      | 시점                |
+| 단계              | 로드되는 내용                                      | 시점                |
 | :--------------- | :------------------------------------------------ | :----------------- |
-| `METADATA`       | 이름, 설명, 프론트매터 필드                          | `discover_skills()` |
-| `INSTRUCTIONS`   | 전체 SKILL.md 본문 텍스트                           | `activate_skill()` |
-| `RESOURCES`      | scripts/, references/, assets/의 파일 목록          | `load_resources()` |
+| 검색              | 이름, 설명, 프론트매터 필드                          | `discover_skills()` |
+| 활성화            | 전체 SKILL.md 본문 텍스트                           | `activate_skill()` |
 
-일반적인 에이전트 실행 중에 스킬은 자동으로 검색되고 활성화됩니다 (`INSTRUCTIONS`로 승격). 프로그래밍 방식으로 사용 가능한 파일을 검사해야 하는 경우에만 `load_resources()`를 사용하세요.
+일반적인 에이전트 실행 중에 스킬은 자동으로 검색되고 활성화됩니다. `scripts/`, `references/`, `assets/` 디렉터리는 파일을 직접 참조해야 하는 에이전트를 위해 스킬의 `path`에서 사용할 수 있습니다.
diff --git a/docs/pt-BR/concepts/skills.mdx b/docs/pt-BR/concepts/skills.mdx
index f2bb33377..1af37f9e2 100644
--- a/docs/pt-BR/concepts/skills.mdx
+++ b/docs/pt-BR/concepts/skills.mdx
@@ -102,14 +102,13 @@ agent = Agent(
 )
 ```
 
-## Níveis de Divulgação
+## Como as Skills São Carregadas
 
-Skills carregam progressivamente através de três níveis:
+Skills carregam progressivamente — apenas os dados necessários em cada etapa são lidos:
 
-| Nível            | O que é carregado                                  | Quando              |
+| Etapa            | O que é carregado                                  | Quando              |
 | :--------------- | :------------------------------------------------ | :------------------ |
-| `METADATA`       | Nome, descrição, campos do frontmatter             | `discover_skills()` |
-| `INSTRUCTIONS`   | Texto completo do corpo do SKILL.md                | `activate_skill()` |
-| `RESOURCES`      | Listagem de arquivos de scripts/, references/, assets/ | `load_resources()` |
+| Descoberta       | Nome, descrição, campos do frontmatter             | `discover_skills()` |
+| Ativação         | Texto completo do corpo do SKILL.md                | `activate_skill()` |
 
-Durante a execução normal do agente, skills são automaticamente descobertas e ativadas (promovidas para `INSTRUCTIONS`). Use `load_resources()` apenas quando precisar inspecionar arquivos disponíveis programaticamente.
+Durante a execução normal do agente, skills são automaticamente descobertas e ativadas. Os diretórios `scripts/`, `references/` e `assets/` estão disponíveis no `path` da skill para agentes que precisam referenciar arquivos diretamente.