From 70a7b7277f69595ca6d88728f3210065d56bd53c Mon Sep 17 00:00:00 2001 From: enyst Date: Mon, 12 Jan 2026 22:15:01 +0000 Subject: [PATCH] Clarify repo skills vs legacy repo.md Co-authored-by: openhands --- sdk/guides/skill.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/sdk/guides/skill.mdx b/sdk/guides/skill.mdx index 6ac5ec04..c661c7ca 100644 --- a/sdk/guides/skill.mdx +++ b/sdk/guides/skill.mdx @@ -173,14 +173,14 @@ tools = [ agent_context = AgentContext( skills=[ Skill( - name="repo.md", + name="grumpy-cat", content="When you see this message, you should reply like " "you are a grumpy cat forced to use the internet.", # source is optional - identifies where the skill came from # You can set it to be the path of a file that contains the skill content source=None, # trigger determines when the skill is active - # trigger=None means always active (repo skill) + # trigger=None means always active (permanent/repo context) trigger=None, ), Skill( @@ -514,8 +514,8 @@ from openhands.sdk.context.skills import load_skills_from_dir repo_skills, knowledge_skills, agent_skills = load_skills_from_dir(skills_dir) ``` -- **repo_skills**: Skills from `repo.md` files (always active) -- **knowledge_skills**: Skills from `knowledge/` subdirectories +- **repo_skills**: Skills with `trigger=None` (always active). These typically come from `.openhands/skills/*.md` files without triggers (some legacy examples used a file named `repo.md`). +- **knowledge_skills**: Skills with a trigger (e.g., `KeywordTrigger` or `TaskTrigger`) that are injected when triggered - **agent_skills**: Skills from `SKILL.md` files (AgentSkills standard) #### `discover_skill_resources()`