FAQ
This chapter helps you resolve issues encountered when using the OpenCode Agent Skills plugin and understand the plugin's security mechanisms. Whether you're facing skill loading failures, script execution errors, or want to understand how the plugin protects your system, you'll find answers here.
What You'll Learn
🔧 Troubleshooting
Resolve 9 common issues including skill loading failures, script execution errors, path security issues, and model loading failures. Troubleshooting methods and solutions provided.
🔒 Security Considerations
Learn about the plugin's core security mechanisms and best practices, including path security checks, YAML parsing security, input validation, and script execution protection.
Learning Path
We recommend learning this chapter's content in the following order:
Troubleshooting → Security Considerations- Learn troubleshooting first: When you encounter problems, consult "Troubleshooting" first to quickly locate and resolve them
- Then learn security: Understand the plugin's security mechanisms and develop safe usage habits
What to do when you encounter issues
If you're encountering a specific problem while using the plugin, jump directly to "Troubleshooting" to find the corresponding symptom. If you want to systematically understand the plugin's security design, read "Security Considerations."
Prerequisites
Recommended to Complete First
- Quick Start: Understand the plugin's basic concepts and installation methods
- Platform Features: Familiarize yourself with core features like skill discovery, loading, and execution
This chapter assumes you have a basic understanding of the plugin. If you're using it for the first time, we recommend completing the above chapters first.
Next Steps
After completing this chapter, you can continue exploring: