ART+COM Agent Skills

A collection of reusable AI agent skills by ART+COM. Each skill gives AI coding agents domain-specific knowledge so they can work effectively with our libraries and tools.

Available Skills

Skill	Description
mqtt-topping	Connect to MQTT brokers, subscribe/publish messages, and query retained data over HTTP using mqtt-topping

Installation

Install skills with the skills CLI:

# List available skills in this repo
npx skills add artcom/agent-skills --list

# Install a specific skill
npx skills add artcom/agent-skills --skill mqtt-topping

# Install all skills
npx skills add artcom/agent-skills --all

# Install to specific agents only
npx skills add artcom/agent-skills --skill mqtt-topping -a claude-code

# Install globally (available across all projects)
npx skills add artcom/agent-skills --skill mqtt-topping -g

Skills are symlinked into your project's .agents/skills/ directory and become available to your AI agent automatically. Use --copy if you prefer independent copies instead of symlinks.

Repository Structure

This repository hosts multiple skills side-by-side. Each skill lives in its own directory under skills/:

skills/
├── mqtt-topping/
│   └── SKILL.md
└── <future-skill>/
    └── SKILL.md

Every skill directory must contain a SKILL.md with YAML frontmatter (name, description) and markdown instructions. The description drives when the AI agent activates the skill — it should cover both what the skill does and the contexts in which it's useful.

Adding a New Skill

1. Create a new directory under skills/<skill-name>/

2. Add a SKILL.md with frontmatter and instructions:

   ---
   name: my-skill
   description: Short description of what this skill does and when to use it.
   ---
   
   # My Skill
   
   Instructions for the AI agent...

3. Optionally add supporting files (scripts/, references/, assets/)

4. Add an entry to the Available Skills table above

5. Commit and push

Resources

• skills.sh — Skill discovery and leaderboard
• Skills CLI docs
• Claude Code skills guide
• Why agent skills?
• The Complete Guide to Building Skills for Claude