Key Features

• Generates skill manifest from a GitHub skills directory
• MCP server for recommending and downloading repository-specific AI agent skills
• Supports stdio and HTTP runtime modes from the same codebase

[!IMPORTANT] This tool doesn't provide security checks. To find official skills repository, visit: https://skills.sh/official

Getting Started

Example MCP Configuration

{
  "mcpServers": {
    "suggest-skills": {
      "command": "npx",
      "args": [
        "-y",
        "suggest-skills",
        "--",
        "--output=.agents/skills",
        "https://github.com/sator-imaging/suggest-skills/blob/main/official/official-skills.md",
        "https://github.com/sator-imaging/suggest-skills/blob/main/community/community-skills.md"
      ],
      "env": {
        "SUGGEST_SKILLS_MANIFEST_URLS": [
          "https://some/skill-manifest.md",
          "https://other/skill-manifest.md"
        ]
      }
    }
  }
}

Official & Community Skills

Prebuilt skill manifests can be found in this repository:

• Official Skills, Agents and Designs
• Community Skills, Agents and Designs

[!TIP] Security scanning is provided by NVIDIA SkillSpector via the CI workflow. Each skill is scanned individually and the resulting risk value is written to the Security Risk column.

Generate a Manifest

npx suggest-skills generate \
  https://github.com/OWNER/REPO/tree/main/skills

npx suggest-skills generate \
  --recursive \
  https://github.com/OWNER/REPO/tree/main/skills

This may write the following files in the current working directory:

• <owner>.<repo>[.<path>].skills.md: entries collected from skill directories that contain SKILL.md
• <owner>.<repo>[.<path>].designs.md: entries collected from skill directories that contain DESIGN.md
• <owner>.<repo>[.<path>].agents.md: entries collected from flat top-level markdown files, with Name and Description columns only
• Accepts plain GitHub repository URLs in generate mode by assuming repo root on main

Generate mode uses these rules:

• GitHub directory discovery uses a recursive tree listing internally
• SKILL.md and DESIGN.md are discovered in skill directories, and bundled assets are any other files next to them or in nested subdirectories
• Symlinks found during generate are not handled specially; they may appear in bundled assets, but are not traversed
• Without --recursive, SKILL.md and DESIGN.md are discovered from direct child directories of the generate root
• With --recursive, only subdirectory search is expanded, so nested directories are also scanned for SKILL.md and DESIGN.md
• Root-level markdown files for .agents.md are still discovered the same way whether --recursive is present or not
• Output file naming stays based on the original generate root whether --recursive is present or not
• Output file names are normalized to remove redundant type suffixes (e.g., some-skills.md instead of some-skills.skills.skills.md)
• DESIGN.md reads optional name and description from YAML front matter, and emits None when description is missing
• flat top-level markdown files with front matter are treated as agent definitions for .agents.md
• Empty generated outputs are skipped, so no file is written and no overwrite prompt is shown for them

Configuration

Environment Variables

GITHUB_PAT is optional and is used for authenticated requests to api.github.com.

SUGGEST_SKILLS_MANIFEST_URLS is required and must contain at le