@@ -178,3 +178,11 @@ Start OpenCode (`jump analytics && opencode`), type `hi`, then look to the right
Typing out detailed prompts is slow. [MacWhisper](https://goodsnooze.gumroad.com/l/macwhisper) is a macOS voice-to-text app that makes it much faster to describe context and work through problems out loud — particularly for longer prompts where you'd otherwise spend more time typing than thinking.
It's noticeably more accurate than built-in macOS Dictation app, and unlike cloud-based transcription it runs entirely on-device, so nothing leaves your machine.
## Skills Setup
Skills provide reusable workflows and conventions that agents can automatically invoke. To use all available Data Team skills:
1. Complete the OpenCode setup steps above
2. Complete the MCP setup steps above (Snowflake/dbt)
3. Clone and symlink the `data-team-agentic-skills` repo by following the [setup instructions](https://gitlab.com/gitlab-data/data-team-agentic-skills#setup-opencode)
@@ -40,8 +40,18 @@ Always run Plan first for anything non-trivial. It's surprisingly good at catchi
If you've set `plan` as your default agent (recommended in the [setup guide](agent-setup.md#step-6-set-plan-as-your-default-agent)), you'll be in Plan mode by default. Switch to Build mode explicitly when you're ready to execute.
## Available Skills and Agents
## Skills
Skills encode reusable, team-specific knowledge — conventions, workflows, and best practices that would otherwise need to be re-explained every session. Rather than prompting from scratch, invoking a skill gives the agent the right context immediately.
For a list of available skills developed by the Data Team, see the [Available Skills](agentic-tool-development.md#available-skills) section in the Agentic Tool Development guide.
### How to Use Skills
Skills are automatically invoked by AI coding tools like OpenCode when the task described in your prompt matches the skill's frontmatter metadata. Well-written frontmatter (especially `name` and `description` fields) enables automatic discovery. You can also explicitly mention a skill by name in your prompt if you know it exists.
### Available Skills
For a list of skills developed by the Data Team, see the [Available Skills](agentic-tool-development.md#available-skills) section in the Agentic Tool Development guide.
### Setup
To enable skills in your OpenCode environment, follow the [Skills Setup](agent-setup.md#skills-setup) instructions in the Agent Setup guide.
