engineering-principles SKILL.md skillA

engineering-principles from j-star-films-studios/vibecode-protocol-suite is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add j-star-films-studios/vibecode-protocol-suite/engineering-principles@v2.0.0

Pins v2.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
j-star-films-studios/vibecode-protocol-suite
Path
assets/.agent/skills/engineering-principles/SKILL.md
Versions recorded
1
Latest version
v2.0.0, committed Aug 21, 2026
Size
7,019 bytes
Repository stars
26
License
ISC

Use when designing systems, structuring code, reviewing diffs, handling state, or adhering to core software engineering discipline principles.

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

# Engineering Principles Suite

A catalogue of 21 foundational principles for software architecture, code quality, state management, and agentic workflows.

## Principles Catalog

Read the specific principle file via `view_file` on demand when applying its rule:

| Principle | When to Apply | File Path |
|---|---|---|
| **`boundary-discipline`** | Apply when wiring validation, error handling, or framework adapters. Concentrate guards at system boundaries (CLI, config, network, external APIs); trust internal types and keep business logic in pure functions. | [`boundary-discipline/SKILL.md`](./boundary-discipline/SKILL.md) |
| **`build-the-lever`** | Apply to any non-trivial work, not just bulk work: edits, migrations, analyses, checks. Build the tool that does it or proves it (codemod, script, generator, or a skill your subagents follow) instead of working by hand. The tool is the artifact a reviewer can rerun. | [`build-the-lever/SKILL.md`](./build-the-lever/SKILL.md) |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add j-star-films-studios/vibecode-protocol-suite/engineering-principles@sha256:8050fcac9b948511

The line at the top of this page pins the label v2.0.0, 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_6acrhy4jgqgjj7ye.svg)](https://markdownregistry.com/a/art_6acrhy4jgqgjj7ye)

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

Versions

The registry has recorded 1 version of this file, committed on Aug 21, 2026.

versioncommittedcommitsizeaudit
v2.0.0 latest2026-08-21 1b830a3 7,019 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 (7019 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

j-star-films-studios/vibecode-protocol-suite · 26 stars · license ISC · pushed 2026-10-17 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_6acrhy4jgqgjj7ye
GET https://markdownregistry.com/api/v1/resolve?ref=j-star-films-studios/vibecode-protocol-suite/engineering-principles
GET https://markdownregistry.com/api/v1/blob/8050fcac9b94851133b487465a03d0654b8a062ad8a9d79297a70076b811c03a

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 j-star-films-studios/vibecode-protocol-suite

skill-curator SKILL.md skill
j-star-films-studios/vibecode-protocol-suite · .agents/skill-curator/SKILL.md · Use when adding, importing, reorganizing, renaming, or refactoring skills according to the Lean Unified Skills…
v1.0.0 · audit A · 26 stars
unslop SKILL.md skill
j-star-films-studios/vibecode-protocol-suite · .agents/skills/unslop/SKILL.md · Use when writing any text, chat responses, documentation, UI copy, or skill instructions. Cuts AI tells, filler, and…
v1.0.0 · audit A · 26 stars
AGENTS.md AGENTS.md file
j-star-films-studios/vibecode-protocol-suite · AGENTS.md
git:20260926.7aeecb2 · audit A · 26 stars
AGENTS.md@assets/.agent/skills AGENTS.md file
j-star-films-studios/vibecode-protocol-suite · assets/.agent/skills/AGENTS.md
git:20260912.a111be5 · audit A · 26 stars
agent-engineering SKILL.md skill
j-star-films-studios/vibecode-protocol-suite · assets/.agent/skills/agent-engineering/SKILL.md · Use when engineering LLM prompts, compiling skills from sources ('source-to-skill'), engineering expert systems…
v2.1.0 · audit A · 26 stars
arena SKILL.md skill
j-star-films-studios/vibecode-protocol-suite · assets/.agent/skills/agent-engineering/arena/SKILL.md · Spawn N parallel candidates at the same task, pick a base, graft the strongest parts of the losers into it. Use for…
git:20260821.1b830a3 · audit A · 26 stars
automate-me SKILL.md skill
j-star-films-studios/vibecode-protocol-suite · assets/.agent/skills/agent-engineering/automate-me/SKILL.md · Use for "automate me", "create/update/refresh my -mode skill", "turn/capture my preferences or working style into a…
git:20260821.1b830a3 · audit A · 26 stars
codex-control SKILL.md skill
j-star-films-studios/vibecode-protocol-suite · assets/.agent/skills/agent-engineering/codex-control/SKILL.md · Use when Pi needs to delegate browser, desktop, or native-plugin tasks to the installed Codex CLI.
v1.0.0 · audit A · 26 stars
to-spec SKILL.md skill
j-star-films-studios/vibecode-protocol-suite · assets/.agent/skills/agent-engineering/conversation-to-spec/SKILL.md · Turn the current conversation into a spec and publish it to the project issue tracker: no interview, just synthesis of…
git:20260821.1b830a3 · audit A · 26 stars
crafting-effective-readmes SKILL.md skill
j-star-films-studios/vibecode-protocol-suite · assets/.agent/skills/agent-engineering/crafting-effective-readmes/SKILL.md · Use when writing or improving README files. Not all READMEs are the same — provides templates and guidance matched to…
git:20260820.4dbe9e4 · audit A · 26 stars
create-verification-skill SKILL.md skill
j-star-films-studios/vibecode-protocol-suite · assets/.agent/skills/agent-engineering/create-verification-skill/SKILL.md · Generate a project-local verification skill that drives your app the way a user does — any language, framework, or…
git:20260821.1b830a3 · audit A · 26 stars
domain-modeling SKILL.md skill
j-star-films-studios/vibecode-protocol-suite · assets/.agent/skills/agent-engineering/domain-modeling/SKILL.md · Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a CONTEXT.md…
git:20260821.1b830a3 · audit A · 26 stars

Every file in j-star-films-studios/vibecode-protocol-suite

Other files named engineering-principles

engineering-principles SKILL.md skill
damianvtran/local-operator · local_operator/skills/builtin/engineering-principles/SKILL.md · Practical engineering judgement: smallest change, subtract before adding, data structures before logic, idempotent…
git:20261012.3e10f8e · audit A · 231 stars
engineering-principles SKILL.md skill
ensodynamics/enso-method · skills/engineering-principles/SKILL.md · The engineering principles the Enso Method depends on — no silent fallbacks, the testing evidence standard (every…
git:20261006.537f98b · audit A · 6 stars
engineering-principles SKILL.md skill
cypher0n3/dotagents · skills/engineering-principles/SKILL.md · Applies good engineering principles and working preferences to coding, design, review, infrastructure, and tooling…
git:20261101.d785285 · audit A · 3 stars

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