npm package: @ivanmaiergpersonal/skills
Description: Install agent skills for Claude Code - Rams, React best practices, web design guidelines, and Vercel deploy
Author: ivanmaierg
Latest version: 1.0.3

# @ivanmaierg/skills

Install agent skills for Claude Code with a single command.

## Installation

```bash
npx @ivanmaierg/skills
```

No configuration required. Skills are installed globally and available in all projects.

## What Gets Installed

| Skill | Command | Source | Description |
|-------|---------|--------|-------------|
| **Rams** | `/rams` | [rams.ai](https://rams.ai) | Accessibility (WCAG 2.1) & visual consistency review |
| **React Best Practices** | Auto-triggers | [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) | 40+ React/Next.js performance optimization rules |
| **Web Design Guidelines** | Auto-triggers | [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) | 100+ accessibility, performance, and UX rules |
| **Vercel Deploy** | `/vercel-deploy` | [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) | Deploy to Vercel directly from conversations |

## Usage

### Rams - Accessibility & Visual Review

```bash
# Review current file or project
/rams

# Review specific file
/rams src/components/Button.tsx

# Review multiple files
/rams src/components/*.tsx
```

Rams checks for:
- WCAG 2.1 accessibility compliance
- Visual inconsistencies
- UI polish issues
- Provides line-by-line fix suggestions with severity ratings

### Vercel Skills (Auto-trigger)

These skills activate automatically when you work on relevant tasks:

```
"Review this component for performance issues"
-> Triggers react-best-practices

"Check accessibility on this form"
-> Triggers web-design-guidelines

"Deploy my app"
-> Triggers vercel-deploy
```

## Manual Installation

If you prefer to install skills individually:

```bash
# Rams (accessibility & visual review)
curl -fsSL https://rams.ai/install | bash

# Vercel skills (react, web design, deploy)
npx add-skill vercel-labs/agent-skills
```

## How It Works

This package orchestrates skill installations:

1. Installs **Rams** via `curl -fsSL https://rams.ai/install | bash`
2. Installs **Vercel Agent Skills** via `npx add-skill vercel-labs/agent-skills -y`

Skills are installed to `~/.claude/skills/` (global) or `.claude/skills/` (project).

## Requirements

- Node.js >= 18
- Claude Code CLI installed
- Internet connection for downloading skills

## Troubleshooting

### Skills not appearing

Restart Claude Code after installation:
```bash
# Exit and restart Claude Code
claude
```

### Permission errors

Ensure you have write access to `~/.claude/`:
```bash
mkdir -p ~/.claude/skills
```

### Curl fails for Rams

Check your internet connection and try manually:
```bash
curl -fsSL https://rams.ai/install | bash
```

## Credits

- [Rams](https://rams.ai) - Accessibility & visual consistency review
- [Vercel Agent Skills](https://github.com/vercel-labs/agent-skills) - React, web design, and deploy skills
- [add-skill](https://add-skill.org) - Universal skill installer by Vercel

## Links

- [npm package](https://www.npmjs.com/package/@ivanmaierg/skills)
- [GitHub repository](https://github.com/ivanmaierg/claude-config)
- [llms.txt](./llms.txt) - LLM-readable documentation

## License

MIT