Package SEO Skill

SEO best practices for npm packages, GitHub repos, and AI agent skills. Maximize discoverability.

Author: Next Frontier
Version: 1.0.0
Tags: seo, npm, github, publishing, marketing, discoverability, packages

When to Use

Use this skill when:

• Publishing a new npm package
• Creating a GitHub repo
• Submitting a skill to ClawdHub
• Updating descriptions/READMEs for better discoverability
• Auditing existing packages for SEO improvements

Hot Keywords (2026)

Always include relevant terms from this list:

AI, automation, vibe coding, cursor, claude, gpt, copilot, agent,
autonomous, mcp, langchain, llm, testing, devtools, cli, typescript,
python, react, nextjs, api, sdk, tool, framework, openai, anthropic,
coding agent, ai assistant, developer tools, productivity

Pro tip: Check X/Twitter trending in tech before publishing for fresh terms.

npm Packages

package.json

{
  "name": "descriptive-seo-friendly-name",
  "description": "Clear value prop with keywords. AI-powered X for Y. Works with Cursor, Claude, GPT.",
  "keywords": [
    "ai",
    "automation", 
    "claude",
    "gpt",
    "cursor",
    "vibe-coding",
    "agent",
    "cli",
    "devtools",
    "mcp",
    "langchain",
    "copilot",
    "testing",
    "typescript",
    "openai",
    "anthropic"
  ],
  "repository": {
    "type": "git",
    "url": "https://github.com/org/repo"
  },
  "homepage": "https://github.com/org/repo#readme",
  "bugs": {
    "url": "https://github.com/org/repo/issues"
  }
}

Rules:

• 10-15 keywords minimum
• Description under 200 chars but keyword-rich
• Include repository, homepage, bugs URLs
• Name should be searchable (avoid obscure names)

README.md Structure

# package-name

[![npm version](https://img.shields.io/npm/v/package-name.svg)](https://npmjs.com/package/package-name)
[![npm downloads](https://img.shields.io/npm/dm/package-name.svg)](https://npmjs.com/package/package-name)
[![license](https://img.shields.io/npm/l/package-name.svg)](LICENSE)

> One-line description with keywords. AI-powered X for Y.

## Works With

- 🤖 Claude / Claude Code
- 🔵 Cursor
- 💚 GPT / ChatGPT
- ⚡ Copilot
- 🧩 MCP servers

## Install

\`\`\`bash
npm install package-name
\`\`\`

## Quick Start

\`\`\`typescript
// Minimal working example
\`\`\`

## Features

- ✅ Feature 1 with keyword
- ✅ Feature 2 with keyword
- ✅ Feature 3 with keyword

## API / Usage

[Details...]

## License

MIT

Key elements:

• Badges at very top
• Hero tagline with keywords
• "Works With" section (shows compatibility)
• Install command above fold
• Quick start code example
• Feature list with checkmarks

GitHub Repos

Description (Under 350 chars)

Format:

[What it does]. [Key benefit]. [Compatibility]. [Call to action].