How do I install the Noticed Search skill?

Run npx skillmds@latest add noticedso/noticed-search in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Noticed Search safe to use?

SkillMD's automated safety review verdict for this skill is PASS. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Noticed Search?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Noticed Search free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Noticed Search?

noticedso (@noticedso) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Noticed Search by noticedso — Agent Skill

Name: Noticed Search
Rating: 4.2 (5 reviews)
Author: noticedso

Noticed Search

Search developer networks using noticed to find people, trace connections, and discover paths through GitHub collaborations and LinkedIn connections. Use when the user asks to find developers, search a professional network, trace a connection, or learn who knows someone.

noticedso Updated Sep 17, 2026

File contents

noticed Search Skill

You have access to the noticed CLI for searching developer networks.

Available Commands

Search Network

noticed search "<query>" [options]

Options:

-l, --limit <n> — Maximum results (default 25, max 50)
-o, --offset <n> — Pagination offset
-s, --source <github|linkedin> — Filter by source
--sort <col:dir> — Sort by name:asc, company:desc, etc.
-p, --paths — Lazily fetch the shortest connection path to the top 5 hits
-j, --json — Output JSON for further processing
--no-color — Disable colors

Examples:

# Search by name
noticed search "Sarah Chen"

# Search by skill/topic
noticed search "AI engineers" --limit 10

# Search by company
noticed search "engineers at Google" --source github

# Get JSON output for processing (includes paths to top 5 hits)
noticed search "react developers" --json --paths

# Paginate results
noticed search "frontend" --offset 25 --limit 25

Find a Path

noticed path @sarahml             # by GitHub login
noticed path 12345                # by github_user_id
noticed path --li sarah-chen      # by LinkedIn username
noticed path @sarahml --json      # machine-readable

Use this when you already know who you want to reach. The CLI resolves a login by searching first, then calls the dedicated /api/search/path endpoint.

Configuration

# Mint an API key in the dashboard at /dashboard/api-keys, then:
noticed config --set-url https://your-instance.noticed.so
noticed config --set-key nk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Show current config
noticed config --show

MCP Server (for AI agent integration)

# Start MCP server over stdio
noticed mcp

Environment Variables

The CLI reads credentials from:

CLI flags (--api-url, --api-key)
Environment variables (NOTICED_API_URL, NOTICED_API_KEY)
Config file (~/.config/noticed/config.json)

Search Tips

Natural language: "AI engineers at startups", "frontend developers who know React"
Names: "Sarah Chen", "John Smith" — searches both GitHub and LinkedIn
Usernames: "@sarahml" — direct GitHub login lookup
Companies: "Google", "Vercel" — matches company fields
Skills/Topics: "kubernetes", "machine learning" — matches skills and repo topics
Combined: Queries with 3+ words automatically validate extra words against company/headline

Connection Paths

When --paths is used, the CLI shows the shortest path from you to each person:

You ──collab──▸ Alice ──LinkedIn──▸ Bob ──collab──▸ Target (3 hops)

This helps understand how you're connected to someone outside your direct network.

---name: noticed-searchdescription: Search developer networks using noticed to find people, trace connections, and discover paths through GitHub collaborations and LinkedIn connections. Use when the user asks to find developers, search a professional network, trace a connection, or learn who knows someone.license: MIT---# noticed Search SkillYou have access to the `noticed` CLI for searching developer networks.## Available Commands### Search Network```bashnoticed search "<query>" [options]```**Options:**- `-l, --limit <n>` — Maximum results (default 25, max 50)- `-o, --offset <n>` — Pagination offset- `-s, --source <github|linkedin>` — Filter by source- `--sort <col:dir>` — Sort by `name:asc`, `company:desc`, etc.- `-p, --paths` — Lazily fetch the shortest connection path to the top 5 hits- `-j, --json` — Output JSON for further processing- `--no-color` — Disable colors**Examples:**```bash# Search by namenoticed search "Sarah Chen"# Search by skill/topicnoticed search "AI engineers" --limit 10# Search by companynoticed search "engineers at Google" --source github# Get JSON output for processing (includes paths to top 5 hits)noticed search "react developers" --json --paths# Paginate resultsnoticed search "frontend" --offset 25 --limit 25```### Find a Path```bashnoticed path @sarahml # by GitHub loginnoticed path 12345 # by github_user_idnoticed path --li sarah-chen # by LinkedIn usernamenoticed path @sarahml --json # machine-readable```Use this when you already know who you want to reach. The CLI resolves a loginby searching first, then calls the dedicated `/api/search/path` endpoint.### Configuration```bash# Mint an API key in the dashboard at /dashboard/api-keys, then:noticed config --set-url https://your-instance.noticed.sonoticed config --set-key nk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx# Show current confignoticed config --show```### MCP Server (for AI agent integration)```bash# Start MCP server over stdionoticed mcp```## Environment VariablesThe CLI reads credentials from:1. CLI flags (`--api-url`, `--api-key`)2. Environment variables (`NOTICED_API_URL`, `NOTICED_API_KEY`)3. Config file (`~/.config/noticed/config.json`)## Search Tips- **Natural language**: "AI engineers at startups", "frontend developers who know React"- **Names**: "Sarah Chen", "John Smith" — searches both GitHub and LinkedIn- **Usernames**: "@sarahml" — direct GitHub login lookup- **Companies**: "Google", "Vercel" — matches company fields- **Skills/Topics**: "kubernetes", "machine learning" — matches skills and repo topics- **Combined**: Queries with 3+ words automatically validate extra words against company/headline## Connection PathsWhen `--paths` is used, the CLI shows the shortest path from you to each person:```You ──collab──▸ Alice ──LinkedIn──▸ Bob ──collab──▸ Target (3 hops)```This helps understand how you're connected to someone outside your direct network.

Frequently asked questions