# Kingsman Search

> Multi-source skill discovery with natural language search and GitHub integration Use when this capability is needed.

- Skill: `tomevault-io/kingsman-search` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/kingsman-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/kingsman-search/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/kingsman-search

---


# Kingsman Search

A backend skill for Kingsman that provides multi-source discovery of agent skills.

## Purpose

Search for agent skills across:

- GitHub repositories with SKILL.md files
- GitHub repositories tagged with agent-skills
- General repositories that could be converted to skills

## Usage

### CLI Interface

```bash
node index.js search --query "text to speech" --pat $GITHUB_PAT --cache-dir /path/to/cache
```

### Input Arguments

| Argument | Required | Description |
|----------|----------|-------------|
| `--query` | Yes | Natural language search query |
| `--pat` | No | GitHub Personal Access Token (improves rate limits) |
| `--cache-dir` | No | Directory for caching results (default: ./cache) |

### Output (JSON to stdout)

```json
{
  "results": [
    {
      "id": "owner/repo",
      "name": "repo-name",
      "owner": "owner",
      "description": "Repository description",
      "stars": 123,
      "forks": 45,
      "lastUpdated": "2026-01-15T00:00:00Z",
      "license": "MIT",
      "hasSkillMd": true,
      "skillPaths": ["path/to/skill"],
      "source": "github-code-search",
      "score": 0.92
    }
  ],
  "rateLimitRemaining": 28,
  "cached": false
}
```

## Features

- **Natural Language Expansion**: Expands common terms (e.g., "text to speech" → "tts OR text-to-speech")
- **Multi-Source Search**: Combines GitHub code search and repository search
- **Smart Ranking**: Prioritizes skill-ready repos, then by stars/recency
- **Caching**: 10-minute cache to reduce API calls
- **Rate Limit Aware**: Reports remaining quota

## Dependencies

- Node.js 18+
- GitHub API access (optional PAT for higher limits)

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/nilhan-demel) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-15 -->