agent-skills-generator

🥈Silver

Agent Skills Generator creates AI agent skills from website documentation. Operations teams use it to convert documentation into Markdown skills for AI agents and LLMs. It includes a VS Code extension and Go CLI for easy integration into existing workflows.

12140Updated 2w ago

Intermediate30min to implementautomation

Saves ~120 min per use

Quick InstallView Source

git clone https://github.com/rodydavis/agent-skills-generator.git

Works with:

Claude

Overview

About This Skill

How to Use

1. **Install the VS Code Extension or Go CLI**: Download the [VS Code extension](https://marketplace.visualstudio.com/items?itemName=agent-skills.generator) or install the Go CLI via `go install github.com/agent-skills/cli@latest`. 2. **Run the Skill Generator**: For the VS Code extension, right-click the documentation file and select "Generate AI Skill". For the CLI, use `agent-skills-generator --url [WEBSITE_URL] --output skill.md`. 3. **Review and Customize**: Open the generated Markdown file in VS Code. Adjust input parameters, error handling, or output format to match your agent's requirements. 4. **Test the Skill**: Use a local LLM (e.g., Ollama or LM Studio) to test the skill with sample inputs. Validate the output structure and error cases. 5. **Integrate into Workflow**: Add the skill to your agent's skill library (e.g., via a Git submodule or package manager) and document its usage for your team.

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/rodydavis/agent-skills-generator

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Convert the documentation from [WEBSITE_URL] into a structured AI agent skill in Markdown format. Follow the format: **Skill Name**: [NAME], **Description**: [ONE_SENTENCE_SUMMARY], **Input Parameters**: [LIST], **Output Format**: [STRUCTURE], **Example Usage**: [CODE_BLOCK]. Ensure the skill is executable by an AI agent and includes error handling for common edge cases.

Example Output

```markdown
**Skill Name**: GitHub Repository Cloner
**Description**: Clones a GitHub repository to the local filesystem with branch selection and error handling.

**Input Parameters**:
- `repo_url` (string): Full URL of the GitHub repository (e.g., `https://github.com/owner/repo.git`).
- `branch` (string, optional): Branch name to clone. Defaults to `main`.
- `target_dir` (string, optional): Local directory path. Defaults to `./repo`.

**Output Format**:
```json
{
  "success": boolean,
  "message": string,
  "repo_path": string,
  "error": string (if applicable)
}
```

**Example Usage**:
```bash
# Clone the 'dev' branch of 'my-project' to './my-project'
skill github-repo-cloner --repo_url "https://github.com/acme/my-project.git" --branch "dev" --target_dir "./my-project"
```

**Error Handling**:
- Invalid repository URL: Returns `{"success": false, "message": "Invalid repository URL", "error": "404 Not Found"}`.
- Branch not found: Returns `{"success": false, "message": "Branch 'feature-x' not found", "error": "BranchNotFound"}`.
- Permission denied: Returns `{"success": false, "message": "Git authentication failed", "error": "PermissionDenied"}`.
```