foreman SKILL.md skillA

foreman from turki-sh/foreman is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add turki-sh/foreman/foreman@v3.0.1

Pins v3.0.1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
turki-sh/foreman
Path
plugins/foreman/skills/foreman/SKILL.md
Versions recorded
5
Latest version
v3.0.1, committed Oct 30, 2026
First version recorded
Aug 25, 2026
Size
57,759 bytes
Repository stars
33
License
MIT

Run a website build as the brain agent. Interview the owner, force the scope and design decisions they would otherwise skip, lock a visual system, write one build brief, then build it here or hand it to any coding agent, and verify and ship it live. Use for any website, landing page, portfolio, personal site, docs site or redesign, including quick ones and when the person says they are short on time, because Survey mode is the fast path (it researches instead of asking). Blueprint is the…

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

# Foreman

**A build playbook by Turki Alshuaibi.**
Version 3.0.1 · Updated 27 October 2026 · MIT · See `CHANGELOG.md`
Repository: https://github.com/Turki-Sh/Foreman

## What you are

You are the brain of this build. You interview, force decisions, lock a visual system, and produce one build brief. Only then does any code get written, by you or by another agent, and you stay in the loop as reviewer and debugger until the site is live.

The order is the product. Who types is a detail.

Everything worth anything here comes from a decision the owner made that they would otherwise have skipped. That is the whole mechanism: the value you add is their judgement, extracted and written down, not yours substituted for theirs. It makes them the authority on every one of those decisions, and it makes you the one who gets them made rather than the one who makes them.

**Governing rule: the agent's ceiling is the brief.** Every step exists to raise the brief.

## Eight rules that outrank the rest of this file

Seven of them govern how you work. The eighth governs who decides, and it outranks the other seven wherever they collide.

### 1. You write no site code before the brief is frozen
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add turki-sh/foreman/foreman@sha256:34a7ce8f11d119a5

The line at the top of this page pins the label v3.0.1, 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_tjuchxkcv5u7jih5.svg)](https://markdownregistry.com/a/art_tjuchxkcv5u7jih5)

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

Versions

The registry has recorded 5 versions of this file, between Aug 25, 2026 and Oct 30, 2026, about one every 16 days.

versioncommittedcommitsizeaudit
v3.0.1 latest2026-10-30 db70fc2 57,759 BA view · diff
v3.0.12026-10-27 9ad3c7b 57,175 BA view · diff
v3.0.02026-10-27 9022f39 56,669 BA view · diff
v3.0.02026-10-27 b1d4b66 55,132 BA view · diff
v2.2.02026-08-25 d325bf0 47,066 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 (57759 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

turki-sh/foreman · 33 stars · license MIT · pushed 2026-11-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_tjuchxkcv5u7jih5
GET https://markdownregistry.com/api/v1/resolve?ref=turki-sh/foreman/foreman
GET https://markdownregistry.com/api/v1/blob/34a7ce8f11d119a5e0d4192dbb3140f8d6aa8b07e168ea5c719c0de45c0729f3

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 turki-sh/foreman

AGENTS.md AGENTS.md file
turki-sh/foreman · AGENTS.md
git:20261027.9ad3c7b · audit A · 33 stars
llms-full.txt@docs llms.txt file
turki-sh/foreman · docs/llms-full.txt
git:20261030.db70fc2 · audit A · 33 stars
llms.txt@docs llms.txt file
turki-sh/foreman · docs/llms.txt
git:20261030.9a1f9b6 · audit A · 33 stars
board SKILL.md skill
turki-sh/foreman · plugins/foreman/skills/board/SKILL.md · Build a reference board for a website. Real sites chosen for this brief, shown as a list or as a visual board with…
v3.0.1 · audit A · 33 stars
llms.txt@plugins/foreman/skills/foreman/assets llms.txt file
turki-sh/foreman · plugins/foreman/skills/foreman/assets/llms.txt
git:20260811.2ab33b6 · audit A · 33 stars
launch SKILL.md skill
turki-sh/foreman · plugins/foreman/skills/launch/SKILL.md · Get a finished website live and found. Hosting, custom domain, DNS records, SSL, head metadata, Open Graph share cards…
v3.0.1 · audit A · 33 stars
palette SKILL.md skill
turki-sh/foreman · plugins/foreman/skills/palette/SKILL.md · Build a website colour palette from a named material instead of the model's defaults. Three variants that differ on…
v3.0.1 · audit A · 33 stars
punch-list SKILL.md skill
turki-sh/foreman · plugins/foreman/skills/punch-list/SKILL.md · Audit any website for what makes it look AI-generated or unfinished, such as dead buttons, missing hover and focus…
v3.0.1 · audit A · 33 stars
llms.txt@site llms.txt file
turki-sh/foreman · site/llms.txt
git:20261027.9ed1c34 · audit A · 33 stars

Every file in turki-sh/foreman

Other files named foreman

foreman SKILL.md skill
v-songbird/foreman · skills/foreman/SKILL.md · The one entrance to Foreman, which keeps a project's plan and task history. Say what you want in plain language and…
git:20260922.60b8983 · audit A · 35 stars

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