Generate Claude AI Skill Files

Generate Claude Code `SKILL.md` files from documentation sources using the `@sygnal/agent-skills` CLI tool. This skill helps you manage Claude Code skills by downloading documentation and creating properly formatted skill files.

What This Skill Does

The `@sygnal/agent-skills` tool automates the creation and management of Claude Code skill files. It downloads documentation from various sources (like Webflow APIs), generates `SKILL.md` files in the `.claude/skills` directory, and maintains a registry in `.agent-skills` for tracking installed skills.

Installation

Before using this skill, ensure the CLI tool is installed globally:

```bash

npm install -g @sygnal/agent-skills

```

Available Commands

1. List Available Skills

Display all available documentation sources and generators:

```bash

agent-skills list

```

**When to use:** To discover what skills can be generated before adding them.

2. Add (Learn) a Skill

Generate and install skill files for a specific documentation source:

```bash

agent-skills add <skill-name>

```

**Examples:**

```bash

Add a single skill

agent-skills add webflow-cloud

Add multiple skills at once

agent-skills add webflow-cloud webflow-data-api

```

**What happens:**

**Note:** The `learn` command is an alias for `add` and works identically.

3. Update Learned Skills

Re-install all skills recorded in `.agent-skills` with latest documentation:

```bash

agent-skills update

```

**When to use:** To refresh all installed skills with updated documentation from their sources.

4. Remove a Skill

Uninstall a skill and remove it from the registry:

```bash

agent-skills remove <skill-name>

```

**What happens:**

Step-by-Step Usage Instructions

To Add a New Skill:

1. **List available skills** to see what's available:

```bash

agent-skills list

```

2. **Choose a skill** from the list and add it:

```bash

agent-skills add <skill-name>

```

3. **Verify installation** by checking `.claude/skills/<skill-name>/SKILL.md` exists

4. The skill is now available for Claude Code to use

To Update All Skills:

1. Run the update command:

```bash

agent-skills update

```

2. All skills in `.agent-skills` will be refreshed with latest documentation

To Remove a Skill:

1. Remove the skill:

```bash

agent-skills remove <skill-name>

```

2. Verify it's been removed from `.claude/skills/` and `.agent-skills`

Creating Custom Skills

You can extend this tool by creating custom generators:

1. Create a new folder in `src/generators` (if working with source)

2. Follow the structure specified in `GENERATOR.md`

3. Define `config.json` with skill metadata

4. Create `SKILL.md` template

Important Notes

Common Use Cases

**Adding API documentation:**

```bash

agent-skills add webflow-cloud webflow-data-api

```

**Keeping skills current:**

```bash

agent-skills update

```

**Cleaning up unused skills:**

```bash

agent-skills remove old-skill-name

```

Constraints