# Agent Harness — Known Community Sources
# These sources are searched by `harness discover` to find
# skills, agents, rules, playbooks, hooks, templates, and MCP servers.
#
# Format:
#   name: Display name
#   url:  GitHub repo URL or registry API endpoint
#   type: github | registry | api
#   content: What kind of content this source provides
#   tags: Searchable tags
#
# Community members can add sources by PR or via `harness sources add`.

version: "1.0"

sources:
  # ── MCP Registries ────────────────────────────────────────────────────────
  - name: "MCP Official Registry"
    url: "https://registry.modelcontextprotocol.io"
    type: registry
    content: [mcp]
    tags: [mcp, tools, official]
    description: "Official Model Context Protocol server registry"

  - name: "Smithery.ai"
    url: "https://smithery.ai"
    type: registry
    content: [mcp]
    tags: [mcp, tools, marketplace]
    description: "MCP server marketplace with ratings and reviews"

  - name: "mcp.run"
    url: "https://www.mcp.run"
    type: registry
    content: [mcp]
    tags: [mcp, tools, hosted]
    description: "Hosted MCP server registry"

  - name: "Glama MCP Servers"
    url: "https://glama.ai/mcp/servers"
    type: registry
    content: [mcp]
    tags: [mcp, tools, curated]
    description: "Curated MCP server directory"

  # ── Skills & Agents ───────────────────────────────────────────────────────
  - name: "Anthropic Skills"
    url: "https://github.com/anthropics/skills"
    type: github
    content: [skills]
    tags: [skills, official, claude, anthropic]
    description: "Official Anthropic Agent Skills repository — pdf, docx, pptx, xlsx, mcp-builder, skill-creator, canvas-design, and more"

  - name: "awesome-claude-code"
    url: "https://github.com/hesreallyhim/awesome-claude-code"
    type: github
    content: [skills, agents, hooks, templates]
    tags: [skills, agents, curated, awesome-list]
    description: "Canonical curated list of Claude Code resources — skills, agents, hooks, plugins, slash commands"

  - name: "wshobson/agents"
    url: "https://github.com/wshobson/agents"
    type: github
    content: [agents, skills]
    tags: [agents, skills, large-collection]
    description: "112 agents and 146 skills for Claude Code (organized as plugins/<topic>/agents/)"
    stats:
      agents: 112
      skills: 146

  # ── Hooks & Rules ─────────────────────────────────────────────────────────
  - name: "karanb192/claude-code-hooks"
    url: "https://github.com/karanb192/claude-code-hooks"
    type: github
    content: [hooks]
    tags: [hooks, lifecycle, community]
    description: "Community collection of Claude Code lifecycle hooks (no official Anthropic hooks repo exists)"

  # ── Templates & Plugins ───────────────────────────────────────────────────
  - name: "Anthropic Plugins (Official)"
    url: "https://github.com/anthropics/claude-plugins-official"
    type: github
    content: [templates, plugins]
    tags: [plugins, templates, official, anthropic]
    description: "Official Anthropic-managed directory of high-quality Claude Code plugins"

  - name: "Anthropic Plugins (Community)"
    url: "https://github.com/anthropics/claude-plugins-community"
    type: github
    content: [templates, plugins]
    tags: [plugins, templates, community, anthropic]
    description: "Community plugin marketplace mirror for Claude Code (Apache-2.0)"

  # ── Lossy analogues — review before enabling ───────────────────────────────
  # These were proposed as replacements for sources that turned out to be
  # fabricated (faf-skills, oh-my-claudecode, obey, VibeGuard). They are real
  # repos but DO NOT match the original descriptions or content shape. Review
  # each one and uncomment if it adds value, or delete the block if not.
  #
  # - name: "daymade/claude-code-skills"
  #   url: "https://github.com/daymade/claude-code-skills"
  #   type: github
  #   content: [skills]
  #   tags: [skills, community, unverified]
  #   description: "REVIEW: closest analogue to mlefrancois/faf-skills (fabricated). Not .faf format."
  #
  # - name: "davila7/claude-code-templates"
  #   url: "https://github.com/davila7/claude-code-templates"
  #   type: github
  #   content: [templates]
  #   tags: [templates, community, unverified]
  #   description: "REVIEW: closest analogue to nicobailon/oh-my-claudecode (fabricated). Templates, not skills/agents."
  #
  # - name: "disler/claude-code-hooks-mastery"
  #   url: "https://github.com/disler/claude-code-hooks-mastery"
  #   type: github
  #   content: [hooks]
  #   tags: [hooks, reference, unverified]
  #   description: "REVIEW: closest analogue to nicobailon/obey (fabricated). Reference repo, not curated collection."

  # No replacement found for stormrageqb/VibeGuard — the GitHub user does not exist.
