ai-skills

AI Skills

A Claude Code plugin with reusable skills for working with files and data.

Installation

Claude Code

# Add the marketplace
/plugin marketplace add inromualdo/ai-skills

# Install a skill
/plugin install xlsx-reader@ai-skills

Manual

git clone https://github.com/inromualdo/ai-skills.git ~/.claude/plugins/ai-skills

Skills

Skill	Description
xlsx-reader	Read and extract data from Excel (.xlsx) files. Multiple read modes (info, preview, range, full) with structured JSON output.

Usage Example

Just ask Claude to work with an Excel file — the skill triggers automatically:

You: Can you read the data in report.xlsx?

Claude: Let me start by inspecting the file structure.
> uv run ${SKILL_DIR}/scripts/read_xlsx.py report.xlsx --mode info

The file has 3 sheets: Summary, Sales, Returns.
"Sales" has 1,200 rows with columns: Date, Product, Quantity, Revenue.

Let me preview the first rows.
> uv run ${SKILL_DIR}/scripts/read_xlsx.py report.xlsx --sheet Sales --rows 5

Here are the first 5 rows:
| Date       | Product   | Quantity | Revenue |
|------------|-----------|----------|---------|
| 2026-01-01 | Widget A  | 50       | 2500    |
| 2026-01-01 | Widget B  | 30       | 1800    |
| ...        | ...       | ...      | ...     |

Requirements

• uv (for Python script dependency management)

Contributing

Adding a new skill

1. Create a directory under skills/ with a SKILL.md containing YAML frontmatter (name + description) and markdown instructions
2. Add scripts in scripts/, reference docs in references/, or templates in assets/ as needed
3. Use ${SKILL_DIR} for paths to bundled resources
4. Update the Skills table in this README

Skill structure

skills/my-skill/
├── SKILL.md              # Required: frontmatter + instructions
├── scripts/              # Optional: executable code
├── references/           # Optional: docs loaded on demand
└── assets/               # Optional: templates, files used in output

Guidelines

• Keep SKILL.md concise — only include what Claude doesn't already know
• Start with --mode info patterns for file-based skills to avoid flooding context
• Test scripts before committing: uv run scripts/my_script.py --help

License

MIT