docs: document path-triggered rules#606
Merged
Merged
Conversation
Reflect software-agent-sdk#3994, which adds path-scoped rules — a skill with `paths:` glob frontmatter (PathTrigger) whose content is injected deterministically into the tool result when the agent touches a matching file, staying out of <available_skills>/<REPO_CONTEXT> and non-invocable. - overview/skills: add path-triggered rules to the loading models, skill types list, and frontmatter-requirements table - overview/skills/path: new conceptual page (frontmatter, glob semantics, injection shape), wired into docs.json nav - sdk/guides/skill: new "Path-Triggered Rules" section plus rows in the injection-behavior and context-loading tables - sdk/arch/skill: add PathTrigger to the diagram, component table, trigger evaluation, and frontmatter fields; new "Path Skills (Rules)" subsection
- Render the injected <EXTRA_INFO> exactly as the SDK emits it: the "matches ..." and "Follow it ..." sentences are on one line, not two (agent_context.get_tool_use_suffix builds them as a single line). - Architecture diagram: route path rules to a distinct "Tool Result" node instead of through Markdown -> Agent Context -> System Prompt. Path rules inject into the tool observation and never enter the system prompt, so the old edge was misleading.
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
VascoSch92
force-pushed
the
vasco/path-triggered-rules-docs
branch
from
f06fbe5 to
8774688
Compare
VascoSch92
changed the title
Round out overview/skills/creating.mdx with a 'Path Triggers (Rules)' accordion alongside Keyword/Description triggers, cross-linking the new path-triggered rules page.
enyst
approved these changes
Jul 6, 2026
Member
|
Oops. I didn't realize it will automerge before the actual SDK PR, sorry! |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
Reflects software-agent-sdk#3994, which adds path-scoped rules to the SDK's Skill machinery. A rule is a skill with
paths:glob frontmatter (a newPathTrigger) whose content is injected deterministically into the tool result when the agent reads/edits/creates a matching file — staying out of<available_skills>and<REPO_CONTEXT>and non-model-invocable, so it adds zero baseline context cost. The docs previously documented onlyNone/KeywordTrigger/TaskTrigger.Changes
overview/skills.mdx— add path-triggered rules to the loading models, the "Skill Types" list, the frontmatter-requirements table, and the cross-reference footer.overview/skills/path.mdx— new conceptual page (modeled onkeyword.mdx): usage,pathsfrontmatter, glob semantics, injection shape, precedence overtriggers. Wired intodocs.jsonnav under Skills.sdk/guides/skill.mdx— new Path-Triggered Rules section (PythonPathTrigger+ file-based example,<EXTRA_INFO>injection shape, glob semantics) plus new rows in the Skill Injection Behavior and Context Loading Methods tables.sdk/arch/skill.mdx— addPathTriggerto the architecture diagram, the Key Components table (linked to the realopenhands/sdk/skills/trigger.py), the Trigger Evaluation table, and the frontmatter fields; new Path Skills (Rules) subsection.Notes
sdk/api-reference/*),openapi/agent-sdk.json, andllms.txt/llms-full.txt(the latter refreshed by the weeklycheck-llms-files.ymljob).