Add skills setup info to docs #2823
Open
+15
−5
Conversation
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
To support workflow for setting up skills locally, a symlink is suggested to be created in the root directory. These files should not be committed. Add common directories for skills configuration.
Docs mention that skills live in .github/skills but most if not all tools don't support this. Add information on how to set up a symlink to get desired skill functionality.
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## master #2823 +/- ##
=======================================
Coverage 71.85% 71.85%
=======================================
Files 134 134
Lines 7340 7340
Branches 1563 1503 -60
=======================================
Hits 5274 5274
Misses 2020 2020
Partials 46 46 ☔ View full report in Codecov by Sentry. 🚀 New features to boost your workflow:
|
yihao03
reviewed
Feb 2, 2026
Comment on lines
+25
to
+26
| ``` | ||
| mkdir .opencode && cd .opencode/ && ln -s ../.github/skills skills |
There was a problem hiding this comment.
consider just linking the entire .opencode to .github as we may use other related features such as subagents
yihao03
reviewed
Feb 2, 2026
| ## AI Skills | ||
|
|
||
| Skills are designed to improve AI agent performance by providing structured instructions and resources for specific tasks. This is applicable to any AI agent with skill support, and developers can point AI agents to the skills directory for structured task handling. | ||
| Skills are designed to improve AI agent performance by providing structured instructions and resources for specific tasks. Skills are best used in conjunction with tools that support skill use, though agents can be manually directed to use the skills as well. |
There was a problem hiding this comment.
should we also cautious against using skills downloaded online blindly without auditing it due to security concerns?
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 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.
What is the purpose of this pull request?
Overview of changes:
Update developer documentation on how to setup tool-specific skills directory. Also update .gitignore to exclude commonly used configuration directories.
Anything you'd like to highlight/discuss:
Testing instructions:
Proposed commit message: (wrap lines at 72 characters)
Add AI skills setup info to developer docs
Checklist: ☑️
Reviewer checklist:
Indicate the SEMVER impact of the PR:
At the end of the review, please label the PR with the appropriate label:
r.Major,r.Minor,r.Patch.Breaking change release note preparation (if applicable):