Skip to content

Platform Features

This chapter dives deep into OpenCode Agent Skills' core functionality modules, including skill discovery, querying, loading, automatic recommendation, script execution, and file reading. After mastering these features, you'll be able to fully leverage the plugin's skill management capabilities to make AI more efficient in serving your development work.

Prerequisites

Before You Begin

Before studying this chapter, ensure you have completed:

What You'll Learn

CourseDescriptionCore Tool
Skill Discovery MechanismUnderstand where the plugin automatically discovers skills and master priority rules-
Query and List Available SkillsUse the get_available_skills tool to find and filter skillsget_available_skills
Load Skills into Session ContextUse the use_skill tool to load skills and understand the XML injection mechanismuse_skill
Automatic Skill RecommendationUnderstand semantic matching principles to let AI automatically discover related skills-
Execute Skill ScriptsUse the run_skill_script tool to execute automation scriptsrun_skill_script
Read Skill FilesUse the read_skill_file tool to access skill support filesread_skill_file

Learning Path

┌─────────────────────────────────────────────────────────────────────────┐
│                         Recommended Learning Order                      │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│   1. Skill Discovery  ──→  2. List Skills  ──→  3. Load Skills         │
│         │                     │                    │                    │
│         │                     │                    │                    │
│         ▼                     ▼                    ▼                    │
│   Where skills come from   Learn to find skills   Master loading        │
│                                                                         │
│                              │                                          │
│                              ▼                                          │
│                                                                         │
│   4. Auto Recommendation  ←──  5. Run Scripts  ←──  6. Read Files       │
│         │                    │                  │                       │
│         ▼                    ▼                  ▼                       │
│   Understand smart match   Run automation    Access support files       │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

Recommended Learning Order:

  1. Learn discovery first - Understand where skills come from and how priority is determined
  2. Then learn querying - Master the usage of get_available_skills tool
  3. Then learn loading - Understand use_skill and XML injection mechanism
  4. Then learn auto-recommendation - Understand how semantic matching works (optional, more theoretical)
  5. Finally learn scripts and files - These are advanced features, learn as needed

Quick Start Path

If you just want to get started quickly, you can learn the first three lessons (discovery → querying → loading), and supplement the others as needed.

Next Steps

After completing this chapter, you can continue learning:

  • Advanced Features - Dive deeper into Claude Code compatibility, Superpowers integration, namespace priorities, and other advanced topics
  • FAQ - Check troubleshooting and security documentation when you encounter issues
  • Appendix - View API reference and best practices