@abarcenas/ai-workflow-template 1.23.0 → 1.26.0

package/.agents/instructions/agent-skill.instructions.md

@@ -1,11 +1,11 @@
 ---
-description: "Guidelines for creating high-quality Agent Skills for GitHub Copilot"
-applyTo: "**/.github/skills/**/SKILL.md, **/.claude/skills/**/SKILL.md"
+description: "Guidelines for creating high-quality Agent Skills for opencode"
+applyTo: "**/.agents/skills/**/SKILL.md"
 ---
 
 # Agent Skills File Guidelines
 
-Instructions for creating effective and portable Agent Skills that enhance GitHub Copilot with specialized capabilities, workflows, and bundled resources.
+Instructions for creating effective and portable Agent Skills that enhance opencode with specialized capabilities, workflows, and bundled resources.
 
 ## What Are Agent Skills?
 
@@ -13,21 +13,20 @@ Agent Skills are self-contained folders with instructions and bundled resources
 
 Key characteristics:
 
-- **Portable**: Works across VS Code, Copilot CLI, and Copilot coding agent
+- **Portable**: Works across opencode environments
 - **Progressive loading**: Only loaded when relevant to the user's request
 - **Resource-bundled**: Can include scripts, templates, examples alongside instructions
-- **On-demand**: Activated automatically based on prompt relevance
+- **On-demand**: Activated automatically based on task relevance
 
 ## Directory Structure
 
-Skills are stored in specific locations:
+Skills are stored in the following standard location:
 
-| Location                         | Scope                | Recommendation                     |
-| -------------------------------- | -------------------- | ---------------------------------- |
-| `.github/skills/<skill-name>/`   | Project/repository   | Recommended for project skills     |
-| `.claude/skills/<skill-name>/`   | Project/repository   | Legacy, for backward compatibility |
-| `~/.github/skills/<skill-name>/` | Personal (user-wide) | Recommended for personal skills    |
-| `~/.claude/skills/<skill-name>/` | Personal (user-wide) | Legacy, for backward compatibility |
+| Location                           | Scope              | Recommendation                     |
+| ---------------------------------- | ------------------ | ---------------------------------- |
+| `.agents/skills/<skill-name>/`     | Project/repository | Standard location for all skills   |
+
+> **Personal skills**: You may also place skills in `~/.config/opencode/skills/<skill-name>/` for user-wide availability across projects. This location is optional and not shown in the table above.
 
 Each skill **must** have its own subdirectory containing at minimum a `SKILL.md` file.
 
@@ -51,7 +50,7 @@ license: Complete terms in LICENSE.txt
 
 ### Description Best Practices
 
-**CRITICAL**: The `description` field is the PRIMARY mechanism for automatic skill discovery. Copilot reads ONLY the `name` and `description` to decide whether to load a skill. If your description is vague, the skill will never be activated.
+**CRITICAL**: The `description` field is the PRIMARY mechanism for automatic skill discovery. opencode reads ONLY the `name` and `description` to decide whether to load a skill. If your description is vague, the skill will never be activated.
 
 **What to include in description:**
 
@@ -73,13 +72,13 @@ description: Web testing helpers
 
 The poor description fails because:
 
-- No specific triggers (when should Copilot load this?)
+- No specific triggers (when should opencode load this?)
 - No keywords (what user prompts would match?)
 - No capabilities (what can it actually do?)
 
 ### Body Content
 
-The body contains detailed instructions that Copilot loads AFTER the skill is activated. Recommended sections:
+The body contains detailed instructions that opencode loads AFTER the skill is activated. Recommended sections:
 
 | Section                     | Purpose                                             |
 | --------------------------- | --------------------------------------------------- |
@@ -92,7 +91,7 @@ The body contains detailed instructions that Copilot loads AFTER the skill is ac
 
 ## Bundling Resources
 
-Skills can include additional files that Copilot accesses on-demand:
+Skills can include additional files that opencode accesses on-demand:
 
 ### Supported Resource Types
 
@@ -106,7 +105,7 @@ Skills can include additional files that Copilot accesses on-demand:
 ### Directory Structure Example
 
 ```
-.github/skills/my-skill/
+.agents/skills/my-skill/
 ├── SKILL.md              # Required: Main instructions
 ├── LICENSE.txt           # Recommended: License terms (Apache 2.0 typical)
 ├── scripts/              # Optional: Executable automation
@@ -164,7 +163,7 @@ Skills use three-level loading for efficiency:
 | --------------- | ----------------------------- | --------------------------------- |
 | 1. Discovery    | `name` and `description` only | Always (lightweight metadata)     |
 | 2. Instructions | Full `SKILL.md` body          | When request matches description  |
-| 3. Resources    | Scripts, examples, docs       | Only when Copilot references them |
+| 3. Resources    | Scripts, examples, docs       | Only when opencode references them |
 
 This means:
 
@@ -267,6 +266,5 @@ This ensures traceability and allows resuming workflows if interrupted.
 ## Related Resources
 
 - [Agent Skills Specification](https://agentskills.io/)
-- [VS Code Agent Skills Documentation](https://code.visualstudio.com/docs/copilot/customization/agent-skills)
 - [Reference Skills Repository](https://github.com/anthropics/skills)
-- [Awesome Copilot Skills](https://github.com/github/awesome-copilot/blob/main/docs/README.skills.md)
+- [opencode Documentation](https://opencode.ai)