llm-friendly-context SKILL.md skillA

llm-friendly-context from shinpr/codex-workflows is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add shinpr/codex-workflows/llm-friendly-context@git:20261022.e38db2d

Pins git:20261022.e38db2d in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
shinpr/codex-workflows
Path
.agents/skills/llm-friendly-context/SKILL.md
Versions recorded
8
Latest version
git:20261022.e38db2d, committed Oct 22, 2026
First version recorded
Jun 24, 2026
Size
6,155 bytes
Repository stars
38
License
MIT

Clarifies inputs, outputs, success criteria, decisions, and unresolved conditions so downstream agents can execute without guessing. Use when writing or revising LLM-facing prompts, handoffs, planning artifacts, reviews, reports, or generated instructions.

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

# LLM-Friendly Context

## Purpose

Use this skill when writing or revising any content another agent will execute or judge: prompts, handoffs, planning artifacts, review findings, completion reports, generated instructions, test skeleton comments, work plans, and task files.

The goal is stable downstream execution. The next agent should know the target action, required inputs, accepted decisions, observable success criteria, and the condition that requires escalation.

## Core Rules

1. **Use positive, executable instructions**
   - State the action the next agent should perform.
   - Convert quality policies into observable acceptance criteria.
   - Keep a prohibition only when it protects an irreversible boundary or shipped contract. Name the protected condition and the allowed action.
   - Example: `Preserve existing public API behavior across the documented compatibility cases.`

2. **Resolve outcome-relevant ambiguity**
   - Clarify an instruction when plausible interpretations would change correctness, requested scope, downstream usability, or verification. Use the least-restrictive sufficient condition, source, or example.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add shinpr/codex-workflows/llm-friendly-context@sha256:bbb053014e7b5631

The line at the top of this page pins the label git:20261022.e38db2d, 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_zlbwf7urwa7n5mnf.svg)](https://markdownregistry.com/a/art_zlbwf7urwa7n5mnf)

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

Versions

The registry has recorded 8 versions of this file, between Jun 24, 2026 and Oct 22, 2026, about one every 17 days.

versioncommittedcommitsizeaudit
git:20261022.e38db2d latest2026-10-22 e38db2d 6,155 BA view · diff
git:20261013.5a1e7252026-10-13 5a1e725 5,952 BA view · diff
git:20260917.67474b72026-09-17 67474b7 5,949 BA view · diff
git:20260915.3b2dc522026-09-15 3b2dc52 5,923 BA view · diff
git:20260905.5bef0fe2026-09-05 5bef0fe 5,755 BA view · diff
git:20260802.aa3bfed2026-08-02 aa3bfed 5,488 BA view · diff
git:20260728.312fef92026-07-28 312fef9 5,438 BA view · diff
git:20260624.59b39852026-06-24 59b3985 4,750 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 (6155 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

shinpr/codex-workflows · 38 stars · license MIT · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_zlbwf7urwa7n5mnf
GET https://markdownregistry.com/api/v1/resolve?ref=shinpr/codex-workflows/llm-friendly-context
GET https://markdownregistry.com/api/v1/blob/bbb053014e7b5631d0e6deae5d661c9b8908b3bc9205b2a47ef2d3706be7e242

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 shinpr/codex-workflows

ai-development-guide SKILL.md skill
shinpr/codex-workflows · .agents/skills/ai-development-guide/SKILL.md · Root-cause discipline, proportionate impact analysis, and implementation completeness assurance. Use when fixing bugs…
git:20261102.2a1d2f6 · audit A · 38 stars
coding-rules SKILL.md skill
shinpr/codex-workflows · .agents/skills/coding-rules/SKILL.md · Repository-aware implementation rules for minimal design surface, contract safety, representative patterns, and…
git:20260922.5475540 · audit A · 38 stars
documentation-criteria SKILL.md skill
shinpr/codex-workflows · .agents/skills/documentation-criteria/SKILL.md · Determines which PRD, ADR, UI Spec, Design Doc, and Work Plan a change requires and where each document lives. Use when…
git:20261102.2a1d2f6 · audit A · 38 stars
external-resource-context SKILL.md skill
shinpr/codex-workflows · .agents/skills/external-resource-context/SKILL.md · Resolves and records one external evidence source required by a current design or verification decision. Use when…
git:20260915.0c8f517 · audit A · 38 stars
implementation-approach SKILL.md skill
shinpr/codex-workflows · .agents/skills/implementation-approach/SKILL.md · Selects the smallest sufficient implementation strategy and verification boundary from current requirements and…
git:20261102.2a1d2f6 · audit A · 38 stars
integration-e2e-testing SKILL.md skill
shinpr/codex-workflows · .agents/skills/integration-e2e-testing/SKILL.md · Selects and specifies the integration/E2E tests that own accepted behavior at the boundary where it is observable.
git:20261102.2a1d2f6 · audit A · 38 stars
recipe-add-integration-tests SKILL.md skill
shinpr/codex-workflows · .agents/skills/recipe-add-integration-tests/SKILL.md · Add integration/E2E tests to existing codebase using Design Docs.
git:20261023.aaf52b6 · audit A · 38 stars
recipe-build SKILL.md skill
shinpr/codex-workflows · .agents/skills/recipe-build/SKILL.md · Execute an approved backend Work Plan autonomously through task execution, quality fixes, commits, and final…
git:20261023.aaf52b6 · audit A · 38 stars
recipe-design SKILL.md skill
shinpr/codex-workflows · .agents/skills/recipe-design/SKILL.md · Execute from codebase-scoped analysis to design document creation.
git:20261102.2a1d2f6 · audit A · 38 stars
recipe-diagnose SKILL.md skill
shinpr/codex-workflows · .agents/skills/recipe-diagnose/SKILL.md · Investigate problem, verify findings, and derive solutions through structured diagnosis.
git:20261023.aaf52b6 · audit A · 38 stars
recipe-front-adjust SKILL.md skill
shinpr/codex-workflows · .agents/skills/recipe-front-adjust/SKILL.md · Adjust an implemented UI with focused evidence, verification, and quality checks.
git:20261023.aaf52b6 · audit A · 38 stars
recipe-front-build SKILL.md skill
shinpr/codex-workflows · .agents/skills/recipe-front-build/SKILL.md · Execute an approved frontend Work Plan autonomously through frontend implementation, quality fixes, commits, and final…
git:20261023.aaf52b6 · audit A · 38 stars

Every file in shinpr/codex-workflows

Other files named llm-friendly-context

llm-friendly-context SKILL.md skill
shinpr/claude-code-workflows · dev-skills/skills/llm-friendly-context/SKILL.md · Clarifies inputs, outputs, success criteria, decisions, and unresolved conditions so downstream consumers can execute…
git:20261019.de01f9e · audit A · 707 stars
llm-friendly-context SKILL.md skill
shinpr/claude-code-workflows · dev-workflows-fullstack/skills/llm-friendly-context/SKILL.md · Clarifies inputs, outputs, success criteria, decisions, and unresolved conditions so downstream consumers can execute…
git:20261019.de01f9e · audit A · 707 stars
llm-friendly-context SKILL.md skill
shinpr/claude-code-workflows · skills/llm-friendly-context/SKILL.md · Clarifies inputs, outputs, success criteria, decisions, and unresolved conditions so downstream consumers can execute…
git:20261019.de01f9e · audit A · 707 stars
llm-friendly-context SKILL.md skill
shinpr/claude-code-workflows · dev-workflows/skills/llm-friendly-context/SKILL.md · Clarifies inputs, outputs, success criteria, decisions, and unresolved conditions so downstream consumers can execute…
git:20261019.de01f9e · audit A · 707 stars
llm-friendly-context SKILL.md skill
shinpr/claude-code-workflows · dev-workflows-frontend/skills/llm-friendly-context/SKILL.md · Clarifies inputs, outputs, success criteria, decisions, and unresolved conditions so downstream consumers can execute…
git:20261019.de01f9e · audit A · 707 stars
llm-friendly-context SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-en/llm-friendly-context/SKILL.md · Clarifies inputs, outputs, success criteria, decisions, and unresolved conditions so downstream agents can execute…
git:20260923.86a3d79 · audit A · 236 stars
llm-friendly-context SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-ja/llm-friendly-context/SKILL.md · 入力・出力・成功基準・決定事項・未解決条件を明確化し、下流エージェントが推測せず実行できるようにする。LLM向けのプロンプト・ハンドオフ・計画成果物・レビュー・レポート・生成指示を記述または改訂する時に使用。
git:20260923.86a3d79 · audit A · 236 stars
llm-friendly-context SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-zh-CN/llm-friendly-context/SKILL.md · 明确输入、输出、成功标准、决策和未解决的条件,使下游智能体无需猜测即可执行。用于编写或修改面向 LLM 的提示词、交接、规划产物、评审、报告或生成的指令。
git:20260923.86a3d79 · audit A · 236 stars

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