will/claude-code
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
a9eaf0114f9427de5ce797f850be3eecd2f0a3f9
claude-code/skills/README.md
OpenCode Test 7ca8caeecb Implement rag-search skill for semantic search 
Add new skill for semantic search across personal state files and
external documentation using ChromaDB and sentence-transformers.

Components:
- search.py: Main search interface (--index, --top-k flags)
- index_personal.py: Index ~/.claude/state files
- index_docs.py: Index external docs (git repos)
- add_doc_source.py: Manage doc sources
- test_rag.py: Test suite (5/5 passing)

Features:
- Two indexes: personal (116 chunks) and docs (k0s: 846 chunks)
- all-MiniLM-L6-v2 embeddings (384 dimensions)
- ChromaDB persistent storage
- JSON output with ranked results and metadata

Documentation:
- Added to component-registry.json with triggers
- Added /rag command alias
- Updated skills/README.md
- Resolved fc-013 (vector database for agent memory)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-04 23:41:38 -08:00

2.4 KiB
Raw Blame History

Skills

Agent skills that extend Claude's capabilities. Model-invoked (Claude decides when to use them).

Available Skills

Skill Description Scripts
gmail Gmail read access check_unread.py, check_urgent.py, search.py
gcal Google Calendar access agenda.py, next_event.py
k8s-quick-status Kubernetes cluster health quick-status.sh
sysadmin-health Arch Linux health check health-check.sh
usage Session usage tracking usage_report.py
programmer-add-project Register projects (workflow only)
rag-search Semantic search (state + docs) search.py, index_personal.py, index_docs.py

Skill Structure

Each skill uses the "Resources Pattern":

skills/skill-name/
├── SKILL.md            # Main instructions (required)
├── scripts/            # Executable helpers
│   ├── action1.py
│   └── action2.sh
└── references/         # Documentation
    └── patterns.md

Skill Format

---
name: skill-name
description: What it does. Use when [trigger conditions].
allowed-tools:
  - Bash
  - Read
---

# Skill Name

## Quick Commands

```bash
./scripts/main-action.py [args]

Request Routing

User Request Action
"do X" Run script with args

Policy

  • Read-only / Write allowed
  • Model tier preferences

## Key Elements

### Description

Critical for discovery. Include:
- What the skill does
- When Claude should use it (trigger phrases)

### allowed-tools

Restricts which tools Claude can use:
- `Bash` - Run commands/scripts
- `Read` - Read files
- `Write` - Write files
- `Edit` - Edit files

### Scripts

Standalone executables that do the work:
- Python: `#!/usr/bin/env python3`
- Bash: `#!/bin/bash`
- Must be executable: `chmod +x`

### References

Supporting documentation:
- Query patterns
- API reference
- Examples

## Adding a Skill

1. Create `skills/name/SKILL.md`
2. Add scripts to `skills/name/scripts/`
3. Make scripts executable
4. Update `component-registry.json` with triggers
5. Test: ask Claude something that should trigger it

## Skill vs Command

| Aspect | Skill | Command |
|--------|-------|---------|
| **Invocation** | Claude decides | User types `/command` |
| **Discovery** | Based on description | Explicit |
| **Use case** | Domain expertise | Quick actions |