playbooks

home / skills / trpc-group / trpc-agent-go / demo-skill

demo-skill skill

/examples/skillloadmode/skills/demo-skill

This skill demonstrates loading and running commands in an isolated workspace to showcase skill_load and SkillLoadMode for safe experimentation.

npx playbooks add skill trpc-group/trpc-agent-go --skill demo-skill

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
283 B
---
name: demo-skill
description: A tiny skill used by the skillloadmode example.
---

# Demo Skill

This skill exists only to demonstrate `skill_load` and SkillLoadMode.

You can load this skill with `skill_load` and then run commands with `skill_run`
inside an isolated workspace.

Overview

This skill demonstrates loading and executing a minimal agent skill using SkillLoadMode. It provides a tiny, self-contained example that shows how to load the skill with skill_load and run commands with skill_run inside an isolated workspace. It is intended as a teaching and testing aid rather than a production component.

How this skill works

The skill exposes a minimal command surface that the loader recognizes and initializes in SkillLoadMode. After loading, you can invoke skill_run to execute commands inside an isolated workspace created by the framework. The skill performs no external side effects and is designed to validate load/run flows and workspace isolation behavior.

When to use it

  • Learning how SkillLoadMode and skill_load interact in the agent framework.
  • Testing agent initialization and isolated workspace behavior without side effects.
  • Demonstrating tool integration and command invocation in examples or tutorials.
  • Validating CI pipelines that need a predictable, lightweight skill to load.
  • Prototyping higher-level orchestration by replacing the demo implementation later.

Best practices

  • Use this demo as a read-only or disposable test target—do not rely on it for production logic.
  • Run the skill inside a completely isolated workspace to verify environment setup and permissions.
  • Combine with automated tests to assert load and run outcomes consistently.
  • Keep interactions deterministic: capture outputs and logs for reproducible debugging.
  • Treat the demo as a template when building more complex skills; replace internals incrementally.

Example use cases

  • Show new contributors how to load a skill and execute commands using skill_load and skill_run.
  • Create CI jobs that assert the agent framework can load and run a simple skill reliably.
  • Use in workshops to demonstrate workspace isolation and to teach safe experimentation.
  • Validate agent lifecycle code paths when upgrading framework components.
  • Quickly prototype a control flow that will later be implemented in a fuller skill.

FAQ

Does this skill perform any network or file system changes?

No. The demo is designed to avoid external side effects and runs inside an isolated workspace.

Can I extend this skill for my own tests?

Yes. Use it as a lightweight template and replace or extend internals to match your test scenarios.