Scan Skill | Agent Skills

Scan

Automatically discovers and installs Claude skills from SkillsMP.com, official sources, and third-party marketplaces based on project context.

When to Use

This skill is invoked when:

/auto-skills command is run

Skill Sources

1. SkillsMP.com

Uses AI semantic search to find relevant skills.

API: GET https://skillsmp.com/api/v1/skills/ai-search

Queries based on context:

| Detected Tech | AI Search Query | |---------------|-----------------| | Go | best practices for Go development performance and testing | | GraphQL | GraphQL schema design and resolver patterns | | Next.js | Next.js server components and performance optimization | | Playwright | Playwright testing best practices and page objects | | React | React component patterns and state management | | TypeScript | TypeScript type safety and utility patterns | | Database | database modeling and query optimization |

2. Official Anthropic Skills

Source: https://github.com/anthropics/skills

3. Compound Engineering (Every Marketplace)

Already installed via compound-engineering@every-marketplace

Installation Process

Check SKILL_INSTALL_LOCATION env var for target location
- workspace → install to ~/.claude/skills/ (default)
- project → install to .claude/skills/
Search SkillsMP using AI semantic queries
Review top 3 results per technology detected
Check for duplicates - skip if already installed
Install to configured location
Log installations for transparency

Commands Used

# Determine installation location
SKILL_DIR="${SKILL_INSTALL_LOCATION:-workspace}"
if [ "$SKILL_DIR" = "workspace" ]; then
  TARGET="$HOME/.claude/skills"
else
  TARGET=".claude/skills"
fi

# Check for existing skills in BOTH locations
get_installed_skills() {
  # Check workspace skills
  if [ -d "$HOME/.claude/skills" ]; then
    for dir in "$HOME/.claude/skills"/*; do
      if [ -d "$dir" ]; then
        basename "$dir"
      fi
    done
  fi

  # Check project skills
  if [ -d ".claude/skills" ]; then
    for dir in ".claude/skills"/*; do
      if [ -d "$dir" ]; then
        basename "$dir"
      fi
    done
  fi
}

INSTALLED_SKILLS=$(get_installed_skills)

# Search SkillsMP API
curl -X GET "https://skillsmp.com/api/v1/skills/ai-search?q=<encoded_query>" \
  -H "Authorization: Bearer $SKILLSMP_API_KEY"

# Check if skill already exists before installing
skill_name="example-skill"
if echo "$INSTALLED_SKILLS" | grep -qx "$skill_name"; then
  echo "✓ $skill_name already installed, skipping"
else
  mkdir -p "$TARGET"
  git clone <repo_url> "$TARGET/$skill_name"
fi

Example Workflow

Given project context:

{
  "languages": ["go"],
  "frameworks": ["graphql"]
}

Actions:

Search SkillsMP: Go development best practices performance testing
Search SkillsMP: GraphQL schema design resolver patterns
Review top 3 results from each search
Filter out already installed skills
Install up to 5 most relevant skills
Report what was installed

Skill Selection Criteria

When reviewing search results, prioritize skills with:

High star count on GitHub (community approval)
Recent updates (actively maintained)
Clear descriptions matching the use case
Relevant tags to detected technologies
Good documentation (README, examples)

Safety Rules

Max 5 new skills per auto-skills run (avoid bloat)
Never overwrite existing skills
Always report what was installed and why
Skip if SKILLSMP_API_KEY is not set
Validate skill structure before installing (must have SKILL.md)
Check for malware in skill code before installing

Transparency

After installing, always output:

## Auto Skills Complete

Skills installed to: ~/.claude/skills/ (workspace)

Installed 3 new skills:

1. **go-performance** (⭐ 234)
   - Go performance optimization patterns
   - Source: github.com/user/go-performance

2. **graphql-schema-design** (⭐ 156)
   - GraphQL schema best practices
   - Source: github.com/user/graphql-skills

3. **testing-patterns** (⭐ 89)
   - Testing strategies for Go and GraphQL
   - Source: skillsmp.com/skills/...

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | SKILL_INSTALL_LOCATION | No | Where to install skills: workspace (~/.claude/skills/) or project (.claude/skills/). Default: workspace | | SKILLSMP_API_KEY | Yes | API key for SkillsMP.com | | AUTO_SKILL_MAX | No | Max skills to install (default: 5) | | AUTO_SKILL_ENABLED | No | Disable auto-skill (default: true) |

Agent Skills: Scan

Install this agent skill to your local

Skill Files