Agent Skills

Reusable skills for AI agents following the Agent Skills v1.0 open standard. Compatible with OpenCode, Claude Code, and any agent that supports the SKILL.md format.

Structure

Each skill is a directory containing a SKILL.md file (required) plus optional supporting files:

skill-name/
├── SKILL.md          # Required: YAML frontmatter + instructions
├── scripts/          # Optional: executable code (Python, Bash, etc.)
├── references/       # Optional: documentation loaded on demand
└── assets/           # Optional: templates, images, data files

Available Skills

Skill	Description
companion-mood	Transforms an agent into a direct, insightful companion for personal conversations, life experiences, and emotional support.

---

Pull: Download skills (agent-side)

Download individual skills without cloning the full repo. Uses GitHub raw URLs — works anywhere with curl.

With install.sh (recommended)

./install.sh --list                         # see available skills
./install.sh companion-mood                 # install into ~/.config/opencode/skills/
./install.sh companion-mood --target ~/.claude/skills   # custom target

Manual curl

# Discover available skills
curl -s https://api.github.com/repos/giulio8/skills/contents/ | jq '.[].name'

# Download a skill's SKILL.md
curl -sL https://raw.githubusercontent.com/giulio8/skills/main/companion-mood/SKILL.md \
  -o ~/.config/opencode/skills/companion-mood/SKILL.md

For AI agents

An agent can self-serve: discover skills via the GitHub Contents API, fetch SKILL.md files from raw.githubusercontent.com, and save them to its configured skill directory. No git clone needed — just HTTP GET.

---

Push: Contribute skills (human-side)

Propose a new skill

git clone https://github.com/giulio8/skills.git
cd skills
# Copy template, write your skill...
cp -r _template my-new-skill
# Edit SKILL.md, add scripts/references if needed
git add my-new-skill/
git commit -m "Add my-new-skill: <description>"
git push origin main

Or fork → PR the usual way.

Edit existing skill

git clone https://github.com/giulio8/skills.git  # or git pull if already cloned
# Edit the skill...
git add companion-mood/SKILL.md
git commit -m "companion-mood: improve <section>"
git push

Via GitHub API (no git)

# Update a single file (base64-encoded content)
curl -X PUT \
  -H "Authorization: token <your-token>" \
  -H "Content-Type: application/json" \
  -d '{"message":"Update companion-mood","content":"'$(base64 -w0 SKILL.md | tr -d '\n')'","sha":"<file-sha>"}' \
  https://api.github.com/repos/giulio8/skills/contents/companion-mood/SKILL.md

---

Contributing

Copy _template/SKILL.md as a starting point. Follow the spec and keep instructions under 500 lines.

See also: Agentskills.io | anthropics/skills