110 lines
3.1 KiB
Markdown
110 lines
3.1 KiB
Markdown
# Skills Library
|
|
|
|
## What Skills Are
|
|
Skills are reusable instructions and workflows that guide the assistant through specialized tasks.
|
|
|
|
## When To Use A Skill
|
|
- The task has a repeatable workflow.
|
|
- You want consistent structure and outputs.
|
|
- The task spans multiple files or steps.
|
|
|
|
## Skills Directory
|
|
Store skills in the team-approved skills directory for your environment. If you do not know the location, ask your team lead or check your internal setup docs.
|
|
|
|
### Example Question To Ask
|
|
Example prompt:
|
|
```text
|
|
Where is the approved skills directory for our team, and how do I add a new skill?
|
|
```
|
|
|
|
## Skills Governance And Sync
|
|
To keep skills consistent across teams, use a central skills registry plus a per-project manifest. Avoid copying skills into every repo unless the skill is tightly coupled to the project.
|
|
|
|
### Recommended Pattern
|
|
- Central skills registry repo (single source of truth)
|
|
- Project-level manifest that pins required skills and versions
|
|
- Sync script that pulls the approved set to each developer's laptop
|
|
- Agents.md points to the manifest and sync command
|
|
|
|
### Project Manifest Example
|
|
Use a small manifest to declare the approved skills and versions for the project:
|
|
|
|
```yaml
|
|
version: 1
|
|
registry: git@<host>:org/mobile-ai-skills.git
|
|
skills:
|
|
- name: swiftui-expert-skill
|
|
version: 1.2.0
|
|
- name: onboarding-cro
|
|
version: 1.0.0
|
|
```
|
|
|
|
### Sync Workflow
|
|
1. Run the sync script.
|
|
2. The script pulls the registry and copies required skills to your local skills directory.
|
|
3. Restart your editor if required.
|
|
|
|
### Example Sync Command
|
|
```bash
|
|
./scripts/sync-skills.sh
|
|
```
|
|
|
|
## How to Download Existing Skills
|
|
1. Locate the skill in the team or org repository.
|
|
2. Add the skill to your local skills directory following team guidance.
|
|
3. Restart the editor or chat if required so the skill is recognized.
|
|
|
|
## How to Enable or Configure Skills
|
|
- Follow the instructions provided in each skill's README or SKILL file.
|
|
- Some skills require additional setup, such as environment variables or tools.
|
|
|
|
## How To Connect Skills
|
|
1. State the primary skill you want to use.
|
|
2. Provide the inputs that skill expects.
|
|
3. If needed, add a secondary skill and explain the handoff.
|
|
|
|
### Example Skill Request
|
|
Example prompt:
|
|
```text
|
|
Use swiftui-expert-skill to review this view for best practices. Then use webapp-testing to validate the web flow.
|
|
```
|
|
|
|
## Current Skills (Add Repo Links)
|
|
Add a short summary and link for each skill below.
|
|
|
|
### onboarding-cro
|
|
- Focus: New user onboarding and activation guidance.
|
|
- Repo: (link)
|
|
|
|
### revenuecat-ios-integration
|
|
- Focus: RevenueCat setup for iOS and SwiftUI.
|
|
- Repo: (link)
|
|
|
|
### find-skills
|
|
- Focus: Discovering and selecting skills for tasks.
|
|
- Repo: (link)
|
|
|
|
### swiftui-expert-skill
|
|
- Focus: SwiftUI best practices and patterns.
|
|
- Repo: (link)
|
|
|
|
### mcp-builder
|
|
- Focus: Building MCP servers and tool integrations.
|
|
- Repo: (link)
|
|
|
|
### pdf
|
|
- Focus: PDF processing workflows.
|
|
- Repo: (link)
|
|
|
|
### skill-creator
|
|
- Focus: Creating and maintaining new skills.
|
|
- Repo: (link)
|
|
|
|
### template-skill
|
|
- Focus: Base template for new skills.
|
|
- Repo: (link)
|
|
|
|
### webapp-testing
|
|
- Focus: Web app testing workflows.
|
|
- Repo: (link)
|