CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

jbaruch/coding-policy

General-purpose coding policy for Baruch's AI agents

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Overview
Quality
Evals
Security
Files

script-as-black-box.mdrules/

alwaysApply:
No
applyTo:
skills/**/SKILL.md, skills/**/*.md — when authoring skills or reference files that invoke scripts
description:
Skills reference the script's contract (inputs, outputs, exit codes, emitted shapes), not its internal logic — thresholds, predicates, formulas, and allowlists live in the script

Script as Black Box

Required Read

  • Before authoring skills or references that invoke scripts, or relying on any exception to this rule, read skills/coding-contracts/references/script-as-black-box.md in full.
  • Its full text and named sections bind as rule content.
  • Resolve the reference within its owning installed plugin.
  • Missing or unreadable content stops the affected action until the plugin is repaired.
  • Read explicitly when triggered.
  • Never @-import the reference.

Boundary

  • Describe inputs, outputs, failures and side effects.
  • The script owns internal thresholds, predicates and allowlists.

rules

agent-delegation.md

agent-worktree-isolation.md

boy-scout.md

ci-safety.md

code-formatting.md

commit-conventions.md

context-artifacts.md

context-writing-style.md

dependency-management.md

error-handling.md

external-repo-contributions.md

file-hygiene.md

hook-action-reporting.md

language-diagnostics.md

no-secrets.md

response-clarity.md

review-severity.md

reviewer-feedback-reading.md

rule-frontmatter.md

script-as-black-box.md

script-delegation.md

ship-on-green.md

skill-authoring.md

stateful-artifacts.md

sync-before-work.md

testing-standards.md

README.md

tile.json