Skip to content

docs: add dynamic command execution for skills#426

Draft
VascoSch92 wants to merge 4 commits intomainfrom
docs/skills-dynamic-command-execution
Draft

docs: add dynamic command execution for skills#426
VascoSch92 wants to merge 4 commits intomainfrom
docs/skills-dynamic-command-execution

Conversation

@VascoSch92
Copy link
Copy Markdown
Contributor

Summary

Document the new inline shell command execution feature (!command`` syntax) for skills that enables dynamic context injection at render time.

This PR adds documentation for the feature introduced in OpenHands/software-agent-sdk#2582.

Changes

SDK Skills Guide (sdk/guides/skill.mdx)

  • Added new "Dynamic Command Execution" section covering:
    • Basic !command`` syntax with examples
    • Safety rules (code blocks are never executed)
    • Escape syntax (\!cmd``) for documenting the syntax itself
    • Error handling (failures, timeouts, truncation)
    • Programmatic render_content() method usage
    • Security warning about command execution privileges

Skill Architecture (sdk/arch/skill.mdx)

  • Added "Dynamic Content Rendering" to core responsibilities
  • Added render_content_with_commands to key components table
  • Added new "Dynamic Content Rendering" section with flow diagram
  • Updated main architecture diagram to include dynamic commands
  • Updated skill file format example to show dynamic values

Related PR

Document the new inline shell command execution feature (! syntax)
for skills that enables dynamic context injection at render time.

- Add 'Dynamic Command Execution' section to SDK skills guide
- Update skill architecture with Dynamic Content Rendering capability
- Update architecture diagram to show dynamic commands flow
- Add render_content_with_commands to key components table

Related to: OpenHands/software-agent-sdk#2582

Co-authored-by: openhands <openhands@all-hands.dev>
all-hands-bot

This comment was marked as outdated.

@mintlify
Copy link
Copy Markdown

mintlify bot commented Mar 31, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
all-hands-ai 🟢 Ready View Preview Mar 31, 2026, 10:32 AM

Copy link
Copy Markdown
Contributor

@all-hands-bot all-hands-bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Taste Rating: 🟢 Good taste - Documentation is technically accurate and well-structured. Verified all details against SDK PR #2582 implementation.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants