Agent Skills › NyxFoundation/speca › spec-discovery

spec-discovery

GitHub

从给定URL出发，递归抓取并发现网站内的技术规格说明书、白皮书及架构文档链接。结合静态抓取与浏览器工具处理动态内容，最终输出去重后的规范文档列表。

.claude/skills/spec-discovery/SKILL.md NyxFoundation/speca

Trigger Scenarios

需要查找项目的技术规格或白皮书从入口URL探索相关技术文档链接

Install

npx skills add NyxFoundation/speca --skill spec-discovery -g -y

More Options

Non-standard path

npx skills add https://github.com/NyxFoundation/speca/tree/main/.claude/skills/spec-discovery -g -y

Use without installing

npx skills use NyxFoundation/speca@spec-discovery

指定 Agent (Claude Code)

npx skills add NyxFoundation/speca --skill spec-discovery -a claude-code -g -y

安装 repo 全部 skill

npx skills add NyxFoundation/speca --all -g -y

预览 repo 内 skill

npx skills add NyxFoundation/speca --list

SKILL.md

Frontmatter

{
    "name": "spec-discovery",
    "context": "fork",
    "description": "Crawl and discover specification documents from a given URL.",
    "allowed-tools": "mcp__fetch__fetch, browser_navigate, browser_scroll, browser_click, browser_view, write"
}

SKILL: Specification Discovery

Mindset

You are a meticulous Web Researcher tasked with finding all relevant technical specification documents starting from a seed URL. Your goal is to be comprehensive and follow all promising links.

Goal

Given a starting URL, navigate the website to find and list all URLs pointing to technical specifications, whitepapers, or architectural documents. These are often found in sections like "Developers", "Documentation", "Technology", or "Whitepaper".

Tools

Primary: mcp__fetch__fetch - Use for static documentation pages (returns Markdown, fast and efficient)
Fallback: Browser tools (browser_navigate, browser_scroll, browser_click, browser_view) - Use for dynamic/JavaScript-rendered pages or when mcp__fetch__fetch fails (403, timeout, JS-required)

Input

A JSON object containing the starting URL:

{
  "url": "https://example.com/project"
}

Procedure

Initial Fetch: Use mcp__fetch__fetch with the provided url to retrieve the page content as Markdown.
Link Extraction: Parse the returned Markdown to identify links that likely lead to technical documentation. Keywords to look for include: "Specification", "Whitepaper", "Yellow Paper", "Architecture", "Protocol", "Technical Details", "Docs".
Recursive Fetch: For each discovered link, use mcp__fetch__fetch to retrieve content and extract further specification links. Limit depth to 2-3 levels.
Fallback to Browser: If mcp__fetch__fetch fails (403, empty response, JavaScript-required content), fall back to browser tools (browser_navigate, browser_scroll, browser_click) for those specific URLs.
Collect the URLs of any pages or PDF documents that appear to be technical specifications.
Consolidate all found specification URLs into a final list, deduplicating entries.

Output Format

Return a JSON object containing a list of found specification URLs. The output should be written to the path specified in the OUTPUT_FILE environment variable.

{
  "start_url": "https://example.com/project",
  "found_specs": [
    {
      "url": "https://example.com/project/docs/specification.md",
      "title": "Project Specification"
    },
    {
      "url": "https://example.com/project/whitepaper.pdf",
      "title": "Project Whitepaper"
    }
  ],
  "metadata": {
    "timestamp": "...",
    "urls_visited": []
  }
}