npm package: @higrowth/skills
Description: AI agent skills for SEO and content workflows - works with Claude Code, Codex, Cursor, and other AI agents
Author: HiGrowth
Latest version: 1.3.0

# @higrowth/skills

AI agent skills for SEO and content workflows. Works with **Claude Code**, **Codex**, **Cursor**, and other AI coding assistants.

[![npm version](https://badge.fury.io/js/%40higrowth%2Fskills.svg)](https://www.npmjs.com/package/@higrowth/skills)

## What are Agent Skills?

Agent Skills are structured instructions that help AI agents understand domain-specific workflows and best practices. When you install these skills, your AI assistant gains specialized knowledge for SEO and content tasks.

## Available Skills

| Skill | Role | Description |
|-------|------|-------------|
| **content-manager-planning** | Content Manager | Weekly planning, opportunity discovery, content plan creation |
| **content-creator-workflow** | Content Creator | Pick tasks, generate content, output markdown |
| **seo-manager-planning** | SEO Manager | SEO opportunity analysis, prioritization, planning |
| **seo-implementer-workflow** | SEO Implementer | Execute optimization tasks, fix issues, improve rankings |

## Installation

### Using add-skill (Recommended)

```bash
# Install all HiGrowth skills
npx add-skill @higrowth/skills

# Or install from GitHub
npx add-skill AayushDev/cgen --path packages/skills
```

### Using Claude Code Plugin

```bash
/plugin add @higrowth/skills
```

### Manual Installation

```bash
# Clone and copy skills
git clone https://github.com/AayushDev/cgen.git
cp -r cgen/packages/skills/skills/* ~/.claude/skills/
```

## Prerequisites

These skills work with the **HiGrowth MCP Server**. You need:

1. A HiGrowth account with API access
2. The MCP server configured in your environment

### MCP Server Setup

Add to your MCP configuration (`.cursor/mcp.json` or similar):

```json
{
  "mcpServers": {
    "higrowth": {
      "command": "npx",
      "args": ["@higrowth/mcp-server"],
      "env": {
        "HIGROWTH_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

Or install the MCP server separately:

```bash
npm install -g @higrowth/mcp-server
```

## Usage

Once installed, just describe your task naturally:

### Content Manager
```
"Let's plan content for next week"
"What opportunities should we focus on?"
"Create a content plan for Q1"
```

### Content Creator
```
"I want to write an article today"
"What content tasks are ready for me?"
"Generate a blog post about [topic]"
```

### SEO Manager
```
"What SEO opportunities do we have?"
"Which pages need optimization?"
"Plan SEO work for this sprint"
```

### SEO Implementer
```
"Help me optimize this page"
"What SEO fixes should I work on?"
"Fix the title tag for [page]"
```

## Role-Based Workflows

### Content Manager Planning Flow
```
Discover Opportunities → Prioritize → Create Plan → Approve → Assign to Team
```

### Content Creator Flow
```
View Tasks → Pick Work → Research → Generate Content → Review → Output Markdown
```

### SEO Manager Planning Flow
```
Analyze Performance → Find Issues → Prioritize → Create Plan → Assign
```

### SEO Implementer Flow
```
View Tasks → Analyze Page → Get Fixes → Implement → Verify → Document
```

## MCP Tools Used

These skills leverage HiGrowth MCP tools:

**Discovery:** `discover_opportunities`, `list_opportunities`, `get_page_keyword_data`

**Planning:** `create_plan_from_opportunities`, `get_plan_details`, `approve_plan`

**Content:** `create_content_plan`, `generate_content`, `run_content_reviews`

**SEO:** `analyze_page`, `get_optimization_fixes`

**Structure:** `get_topic_structure`, `list_pillars`, `list_topics`

## Skill File Structure

```
@higrowth/skills/
├── AGENTS.md                          # Main agent instructions
├── skills/
│   ├── content-manager-planning/
│   │   └── SKILL.md
│   ├── content-creator-workflow/
│   │   └── SKILL.md
│   ├── seo-manager-planning/
│   │   └── SKILL.md
│   └── seo-implementer-workflow/
│       └── SKILL.md
└── .claude-plugin/
    └── marketplace.json               # Plugin marketplace config
```

## Contributing

Found a way to improve a skill? Contributions welcome!

1. Fork the repository
2. Edit skill files in `packages/skills/skills/`
3. Submit a PR with clear description

### Ideas for Contributions
- Improve existing workflows
- Add new role-specific skills
- Better examples and templates
- Additional MCP tool integrations

## Related Packages

- [@higrowth/mcp-server](https://www.npmjs.com/package/@higrowth/mcp-server) - MCP server for HiGrowth tools

## Links

- [HiGrowth Platform](https://higrowth.app)
- [MCP Server Documentation](https://github.com/AayushDev/cgen/tree/main/packages/mcp-server)
- [Agent Skills Standard](https://agentskills.io)

## License

MIT