search-engine SKILL.md skillA

search-engine from pierry/harness-kit is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add pierry/harness-kit/search-engine@git:20260615.091526b

Pins git:20260615.091526b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
pierry/harness-kit
Path
.claude/agents/system-architect/skills/search-engine/SKILL.md
Versions recorded
1
Latest version
git:20260615.091526b, committed Jun 15, 2026
Size
8,635 bytes
Repository stars
4
License
MIT

Design a web-scale search engine (crawler, processing, indexing, query serving). Topic playbook from the System Design series EP24. Use when the system is a search engine, web crawler, or large-scale retrieval system. Sensors and evals gate.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

Design a search engine. Topic playbook. The agent loads this canned reference architecture and
adapts it to the user's actual scale and constraints, then emits the SDD via the generic template.

Use when the problem is: web search, site/doc search at scale, a crawler, or a large retrieval
system. For internal doc search at small scale, say so and simplify (often a managed engine is the
whole answer).

Ask once if missing: corpus scope (internal docs vs open web), target QPS, freshness SLO, build vs
buy appetite.

Read:
- guides/design-method.md
- guides/writing-style.md
- guides/templates/system-design.md
- guides/pipeline.md

Generate the SDD using the template, filled with the reference below, adapted to user scale.

Save to .claude/runtime/outputs/architect/design/{feature_id}.md.
Sensors: sensors/design-structure.md, sensors/design-rigor.md. Evals: evals/design-quality.md.

---

## Reference architecture (adapt, do not copy blindly)

One line: a search engine is a distributed factory that turns URLs into rankable documents. It is a
chain of decisions: what to discover, fetch, store, index, retrieve, promote. Each stage kills bad
cost and keeps useful signal.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add pierry/harness-kit/search-engine@sha256:ad0a2325be146f68

The line at the top of this page pins the label git:20260615.091526b, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_htz2yjlh3r3mod73.svg)](https://markdownregistry.com/a/art_htz2yjlh3r3mod73)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Jun 15, 2026.

versioncommittedcommitsizeaudit
git:20260615.091526b latest2026-06-15 091526b 8,635 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (8635 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

pierry/harness-kit · 4 stars · license MIT · pushed 2026-10-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_htz2yjlh3r3mod73
GET https://markdownregistry.com/api/v1/resolve?ref=pierry/harness-kit/search-engine
GET https://markdownregistry.com/api/v1/blob/ad0a2325be146f68ff8293dbf89a319df641413314e7f0066538ebb7747dd224

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from pierry/harness-kit

prd SKILL.md skill
pierry/harness-kit · .claude/agents/product-manager/skills/prd/SKILL.md · Generate a Product Requirements Document for an team squad. Business-facing artifact. Sensors and evals gate.
git:20261005.0119af1 · audit A · 4 stars
prp SKILL.md skill
pierry/harness-kit · .claude/agents/product-manager/skills/prp/SKILL.md · Generate a Product Requirements Prompt for engineering handoff. Needs an approved PRD. Sensors, link validation, and…
git:20261005.0119af1 · audit A · 4 stars
backend SKILL.md skill
pierry/harness-kit · .claude/agents/staff-software-engineer/skills/backend/SKILL.md · Backend engineering conventions for team. Java/Kotlin servers. Project conventions in .claude/conventions/backend.md…
git:20260519.492683a · audit A · 4 stars
designer SKILL.md skill
pierry/harness-kit · .claude/agents/staff-software-engineer/skills/designer/SKILL.md · Visual + UX design defaults for new UIs. Material Design 3, dark/light theme, modern type, Behance-grade polish, i18n…
git:20260713.2e25692 · audit A · 4 stars
devops SKILL.md skill
pierry/harness-kit · .claude/agents/staff-software-engineer/skills/devops/SKILL.md · DevOps engineering conventions for team. CI/CD, infra-as-code, observability. Project conventions in…
git:20260519.492683a · audit A · 4 stars
mobile SKILL.md skill
pierry/harness-kit · .claude/agents/staff-software-engineer/skills/mobile/SKILL.md · Mobile engineering conventions for team. iOS and Android. Project conventions in .claude/conventions/mobile.md override…
git:20260519.492683a · audit A · 4 stars
web SKILL.md skill
pierry/harness-kit · .claude/agents/staff-software-engineer/skills/web/SKILL.md · Web frontend engineering conventions for team. Vue.js stack. Project conventions in .claude/conventions/web.md override…
git:20260519.492683a · audit A · 4 stars
design SKILL.md skill
pierry/harness-kit · .claude/agents/system-architect/skills/design/SKILL.md · Design any system from scratch into a rigorous System Design Doc. Generic fallback when no topic-specific playbook…
git:20261005.0119af1 · audit A · 4 stars
rate-limiter SKILL.md skill
pierry/harness-kit · .claude/agents/system-architect/skills/rate-limiter/SKILL.md · Design a distributed rate limiter at scale, policy model, enforcement layers (edge/gateway/service), algorithms (token…
git:20260615.091526b · audit A · 4 stars
review SKILL.md skill
pierry/harness-kit · .claude/agents/system-architect/skills/review/SKILL.md · Adversarial design review of a System Design Doc. Interrogates the staff questions, finds the cost-explosion and…
git:20260615.091526b · audit A · 4 stars
url-shortener SKILL.md skill
pierry/harness-kit · .claude/agents/system-architect/skills/url-shortener/SKILL.md · Design a URL shortener at scale (TinyURL / bit.ly style): short-code generation, redirect path, cache, partitioning…
git:20260615.091526b · audit A · 4 stars
AGENTS.md AGENTS.md file
pierry/harness-kit · AGENTS.md
git:20260710.da128bb · audit A · 4 stars

Every file in pierry/harness-kit

Browse by kind, by grade A, or by owner.