find-skills

name	find-skills
description	Helps users discover, install, and manage agent skills in XOPC workspace
license	MIT

Find Skills

This skill helps you discover, install, and manage skills in the XOPC ecosystem.

When to Use This Skill

Use this skill when the user:

• Asks "how do I do X" where X might be a common task with an existing skill
• Says "find a skill for X" or "is there a skill for X"
• Asks "can you do X" where X is a specialized capability
• Wants to install a skill from GitHub or skills.sh
• Needs to manage installed skills (enable, disable, configure)
• Wants to browse available skills

XOPC Skills CLI Commands

XOPC provides built-in commands for skill management:

List Available Skills

# List all skills (builtin + workspace + global)
xopc skills list

# Show detailed information
xopc skills list -v

# JSON format
xopc skills list --json

Install Skills

From GitHub:

# Clone a skill repository to workspace
git clone <repo-url> ~/.xopc/workspace/main/skills/<skill-name>

# Example: Install vercel-react-best-practices
git clone https://github.com/vercel-labs/agent-skills.git ~/.xopc/workspace/main/skills/vercel-react-best-practices-temp
mv ~/.xopc/workspace/main/skills/vercel-react-best-practices-temp/SKILL.md ~/.xopc/workspace/main/skills/vercel-react-best-practices/SKILL.md
rm -rf ~/.xopc/workspace/main/skills/vercel-react-best-practices-temp

Using xopc skills install (for skills with install specs):

# Install skill dependencies
xopc skills install <skill-name>

# Specify install method
xopc skills install <skill-name> -i <install-id>

# Dry run (preview)
xopc skills install <skill-name> --dry-run

Enable/Disable Skills

# Enable a skill
xopc skills enable <skill-name>

# Disable a skill
xopc skills disable <skill-name>

Check Skill Status

# Show all skills status
xopc skills status

# Show specific skill details
xopc skills status <skill-name>

# JSON format
xopc skills status --json

Configure Skills

# Show current configuration
xopc skills config <skill-name> --show

# Set API key
xopc skills config <skill-name> --api-key=YOUR_API_KEY

# Set environment variables
xopc skills config <skill-name> --env API_KEY=value --env DEBUG=true

Test Skills

# Test all skills
xopc skills test

# Test specific skill
xopc skills test <skill-name>

# Validate SKILL.md file
xopc skills test validate ./skills/weather/SKILL.md

# Security audit
xopc skills test security --deep

How to Help Users Find and Install Skills

Step 1: Understand What They Need

When a user asks for help with something, identify:

1. The domain (e.g., React, testing, design, deployment)
2. The specific task (e.g., writing tests, creating animations, reviewing PRs)
3. Whether a skill likely exists for this common task

Step 2: Search for Skills

Option A: Check installed skills first

xopc skills list -v

Option B: Search online skill repositories

Use your browsing capabilities to search:

• https://skills.sh/ - Official skills marketplace
• GitHub: Search for "agent-skills" or "claude-skills"
• Popular repos:
  • vercel-labs/agent-skills
  • ComposioHQ/awesome-claude-skills

Step 3: Install the Skill

For XOPC-compatible skills:

1. Check if skill has install specs in SKILL.md:

   xopc skills status <skill-name>
   

2. Install dependencies (if any):

   xopc skills install <skill-name>
   

For GitHub skills (manual installation):

1. Create skill directory in workspace:

   mkdir -p ~/.xopc/workspace/main/skills/<skill-name>
   

2. Download SKILL.md:

   # From GitHub
   curl -L https://raw.githubusercontent.com/<owner>/<repo>/main/skills/<skill-name>/SKILL.md \
     -o ~/.xopc/workspace/main/skills/<skill-name>/SKILL.md
   
   # Or clone and copy
   git clone <repo-url> /tmp/skill-temp
   cp /tmp/skill-temp/skills/<skill-name>/SKILL.md ~/.xopc/workspace/main/skills/<skill-name>/
   rm -rf /tmp/skill-temp
   

3. Verify installation:

   xopc skills list | grep <skill-name>
   

Step 4: Present Results to User

When you find relevant skills, present them with:

1. Skill name and description
2. Installation status (already installed / needs installation)
3. Install command (if not installed)
4. Link to learn more

Example response:

I found a skill that might help!

📦 vercel-react-best-practices
   React and Next.js performance optimization guidelines from Vercel Engineering.

Status: ✅ Already installed

You can start using it immediately! Just ask me to help with React optimization tasks.

Or if not installed:

I found a skill that might help!

📦 vercel-react-best-practices
   React and Next.js performance optimization guidelines from Vercel Engineering.

To install it, run:
  xopc skills install vercel-react-best-practices

Or manually:
  mkdir -p ~/.xopc/workspace/main/skills/vercel-react-best-practices
  curl -L https://raw.githubusercontent.com/vercel-labs/agent-skills/main/skills/vercel-react-best-practices/SKILL.md \
    -o ~/.xopc/workspace/main/skills/vercel-react-best-practices/SKILL.md

Learn more: https://skills.sh/vercel-labs/agent-skills/vercel-react-best-practices

Step 5: Offer to Install

If the user wants to proceed, you can help them install:

# For XOPC skills with install specs
xopc skills install <skill-name> -y

# For GitHub skills (automated)
mkdir -p ~/.xopc/workspace/main/skills/<skill-name>
curl -L <skill-url>/SKILL.md -o ~/.xopc/workspace/main/skills/<skill-name>/SKILL.md

Common Skill Categories

Category	Example Queries	Popular Skills
Web Development	react, nextjs, typescript, css, tailwind	vercel-react-best-practices
Testing	testing, jest, playwright, e2e	playwright-testing
DevOps	deploy, docker, kubernetes, ci-cd	docker-compose, github-actions
Documentation	docs, readme, changelog, api-docs	api-documentation
Code Quality	review, lint, refactor, best-practices	code-review-checklist
Design	ui, ux, design-system, accessibility	accessibility-checklist
Productivity	workflow, automation, git	git-workflow

Skill Directory Structure

Skills must be installed in the correct directory structure:

~/.xopc/workspace/main/skills/
├── <skill-name>/           ← Each skill needs its own directory
│   ├── SKILL.md            ← Required: Skill metadata and instructions
│   ├── config.json         ← Optional: Default configuration
│   └── scripts/            ← Optional: Helper scripts
├── another-skill/
│   └── SKILL.md
└── ...

⚠️ Common Mistake: Don't put SKILL.md directly in skills/ directory!

Correct:

~/.xopc/workspace/main/skills/my-skill/SKILL.md

Incorrect:

~/.xopc/workspace/main/skills/SKILL.md  ← Won't be loaded!

Skill Installation Methods

Method 1: XOPC Built-in Install (Recommended)

For skills that declare install dependencies:

# Check what will be installed
xopc skills install <skill-name> --dry-run

# Install
xopc skills install <skill-name>

This method:

• ✅ Automatically installs dependencies (brew, pnpm, go, etc.)
• ✅ Performs security scanning
• ✅ Validates the skill
• ✅ Reports any issues

Method 2: Manual GitHub Installation

For skills without install specs:

# 1. Create directory
mkdir -p ~/.xopc/workspace/main/skills/<skill-name>

# 2. Download SKILL.md
curl -L https://raw.githubusercontent.com/<owner>/<repo>/main/skills/<skill-name>/SKILL.md \
  -o ~/.xopc/workspace/main/skills/<skill-name>/SKILL.md

# 3. Verify
xopc skills list | grep <skill-name>

Method 3: Git Clone

For complex skills with multiple files:

# Clone to temp location
git clone <repo-url> /tmp/skill-clone

# Copy skill directory
cp -r /tmp/skill-clone/skills/<skill-name> ~/.xopc/workspace/main/skills/

# Clean up
rm -rf /tmp/skill-clone

# Verify
xopc skills status <skill-name>

Troubleshooting

Skill Not Loading

Check directory structure:

# Should show SKILL.md in a subdirectory
ls -la ~/.xopc/workspace/main/skills/<skill-name>/

Validate SKILL.md format:

xopc skills test validate ~/.xopc/workspace/main/skills/<skill-name>/SKILL.md

Check for errors:

xopc skills list --json | jq '.diagnostics'

Installation Failed

Check dependencies:

xopc skills status <skill-name>

Manual installation:

# If skill requires 'curl'
brew install curl  # macOS
sudo apt-get install curl  # Linux

Retry:

xopc skills install <skill-name>

Skill Not Working

1. Check if enabled:

   xopc skills status <skill-name>
   

2. Enable if needed:

   xopc skills enable <skill-name>
   

3. Check configuration:

   xopc skills config <skill-name> --show
   

4. Set API key if required:

   xopc skills config <skill-name> --api-key=YOUR_KEY
   

Examples

Example 1: User asks about React performance

User: "How can I make my React app faster?"

You:

1. Check installed skills: xopc skills list | grep -i react
2. If found: "You have the vercel-react-best-practices skill installed!"
3. If not found: Offer to install it

Example 2: User wants to add testing capability

User: "Can you help me write Playwright tests?"

You:

1. Search for testing skills
2. Found: playwright-testing
3. Install:

   mkdir -p ~/.xopc/workspace/main/skills/playwright-testing
   curl -L <url>/SKILL.md -o ~/.xopc/workspace/main/skills/playwright-testing/SKILL.md
   

4. Verify: xopc skills status playwright-testing

Example 3: User wants to browse all skills

User: "What skills do you have?"

You:

xopc skills list -v

Then present the list with descriptions.

Tips for Effective Skill Management

1. Always verify installation: Run xopc skills list after installing
2. Check skill status: Use xopc skills status <name> for details
3. Keep skills updated: Periodically check for skill updates
4. Review security: Run xopc skills test security for audits
5. Organize workspace: Keep only needed skills to reduce clutter

References

• Skills Marketplace: https://skills.sh/
• XOPC Skills CLI: xopc skills --help
• Skill Format: SKILL.md frontmatter specification
• GitHub Skills: Search "agent-skills" on GitHub