Skip to content
cccskills
FreePublished on GitHubEnglish overview

principle-encode-lessons-in-structure

Turn repeated corrections into automated safeguards, such as code checks, metadata flags, or scripts. This skill helps choose where each lesson belongs and turns recurring mistakes into concrete changes or actionable tasks.

OriginalShow the original description

Apply when you catch yourself writing the same instruction a second time, or notice a recurring correction. Encode the rule as a lint, metadata flag, runtime check, or script instead of more text.

AI rating90/ 100See how to install

Good for

  • Preventing the same coding mistake from recurring
  • Turning repeated instructions into automated checks
  • Sorting corrections into notes, rules, or broader principles
  • Clarifying instructions that still require human judgment

Overview

What it does

Replaces repeated written corrections and reminders with mechanisms that prevent mistakes. Options include lint rules that check code without running it, metadata flags, runtime checks, and automation scripts. When several approaches are possible, it chooses the strongest way to prevent the error in that situation.

When it helps

Use it when you write the same reminder a second time or repeatedly receive the same feedback from someone else. It reviews corrections and test failures to distinguish isolated events from recurring problems. Lessons are then directed to notes, skills or lint rules, or broader principles, depending on their scope. The work goes beyond recording a lesson: it applies the change immediately or leaves a concrete task to carry it out.

Example requests

  • “Find an automatic check that can prevent this mistake I keep pointing out.”
  • “Review this correction and identify what could become a shared rule.”
  • “Add failure examples to clarify reminders that cannot be automated.”

Notes

Instructions that require judgment cannot always become automated safeguards. In those cases, make the instruction more prominent and add a failure example. When a mechanism can address the problem, use that mechanism alone and remove duplicate written instructions.

This overview was written by AI (OpenAI Codex) from the public SKILL.md. Check the original below for the exact behavior.

Objective evaluation

AI rated this skill on four points using only the contents of its SKILL.md. Stars and popularity are not taken into account.

Clear instructionsIs it clear when to use it and what it does?
AGoodIt identifies repeated instructions as the trigger and specifies replacing them with checks or scripts.
Concrete stepsAre steps, inputs, outputs, and examples spelled out?
BPartly lackingDecision and routing steps are provided, but check implementations and output formats are not.
SafetyAre sending data, deleting files, and running commands disclosed?
AGoodDeletion targets instructions replaced by mechanisms; external transmission and credential access are not prescribed.
Easy setupDoes it need few tools or API keys, and are they documented?
AGoodNo specific tool installation, API key, or service subscription is required.

The total counts each point as A = 25, B = 15, C = 5. Rated by AI (OpenAI Codex) as of Oct 21, 2026. Treat it as a guide and read the original before installing.

Disagree? Request a re-evaluation

Tell us which point is wrong and why. No login needed. We will check it against the SKILL.md, redo the evaluation, and show the result here.

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

Files included (2)

  • SKILL.md2.2 KB
  • LICENSE1.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Encode Lessons in Structure

Encode recurring fixes in mechanisms (tools, code, metadata, automation) instead of textual instructions. Every error, human correction, and unexpected outcome is a learning signal. Capture it, route it, and close the loop.

Why: Textual instructions are easy to miss. They require the reader to notice, remember, and comply. Structural mechanisms (lint rules, metadata flags, runtime checks, automation scripts) enforce the rule without cooperation.

Pattern: When you catch yourself writing the same instruction a second time:

  1. Ask: can this be a lint rule, a metadata flag, a runtime check, or a script?
  2. If yes, encode it. Delete the instruction
  3. If no (requires judgment), make the instruction more prominent and add an example of the failure mode

Pick the strongest mechanism. When more than one mechanism would work, choose the strongest the situation allows (an unrepresentable state that cannot compile, then a lint or banned API that fails CI, then a canonical helper, then a runtime check), because agents copy whatever the surrounding code already does and a weaker guard becomes the next template.

Corollary: If the fix is structural, only use the structural fix. The instruction is the symptom.

Feedback loop:

  • Capture every correction. When the human intervenes or tests fail, decide if it's a one-off or a pattern.
  • Route to the right layer. One-off -> brain note. Recurring fix -> skill or lint rule. Systemic issue -> principle.
  • Close the loop. Don't just record. Apply now or create a concrete todo.

Anti-patterns:

  • Acknowledging without recording ("I'll keep that in mind" does not persist)
  • Recording without routing (a brain note about a lint rule that should exist is wasted unless the lint rule gets implemented)
  • Fixing without generalizing (fixing one instance while leaving the recurring pattern intact)

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

canary

FreeSummaryAI rating 80

Find a trial Storybook package for a specific branch, or trigger its publication when needed. Check release progress and obtain the package reference or commands for creating or upgrading a project with that build.

  • Find a trial package for a Storybook branch
  • Publish a trial build for a fork pull request
  • Check publication progress and installation commands
storybookjs/storybook91.3KUpdated Oct 22, 2026

component-docs

FreeSummaryAI rating 90

Look up a project's existing UI components in Storybook, including their props, or configuration inputs, and usage examples. Use the findings to answer questions and identify components to reuse before building duplicates.

  • Find existing UI components
  • Check component props and usage examples
  • Answer questions about component usage
storybookjs/storybook91.3KUpdated Oct 22, 2026

docs-review

FreeSummaryAI rating 90

Review, improve, rewrite, or draft Storybook documentation in /docs. Assess each page’s purpose, audience, structure, and examples, then make suitable edits or provide a content plan, with formatting checks after changes.

  • Improve the structure and examples of a documentation page
  • Draft documentation for a new feature
  • Plan page types and outlines
storybookjs/storybook91.3KUpdated Oct 22, 2026

fix-linting-types-on-pr

FreeSummaryAI rating 80

Check out a GitHub pull request, fix linting and TypeScript errors, and commit and push the changes. The workflow supports forked pull requests and repeats type checks to verify fixes while keeping changes focused on these errors.

  • Fix linting errors in a pull request
  • Resolve TypeScript errors in a pull request
  • Apply fixes to a pull request from a fork
storybookjs/storybook91.3KUpdated Oct 22, 2026

github-qa-labels

FreeSummaryAI rating 80

Organize GitHub issues and pull requests found during quality assurance testing. Apply release tracking labels, classify bugs by four severity levels, and label multiple findings while keeping documentation issues and feature requests outside the severity scheme.

  • Group QA findings by release
  • Classify bugs by severity
  • Apply labels to multiple issues and pull requests
storybookjs/storybook91.3KUpdated Oct 22, 2026

handle-pr-comments

FreeSummaryAI rating 90

Work through unresolved GitHub pull request reviews one at a time. The skill explains each comment, proposes a fix, asks how to proceed, and handles chosen edits, replies, commits, and thread resolution.

  • Addressing unresolved pull request review comments
  • Choosing between a code fix, a reply, or skipping a comment
  • Handling duplicate review comments together
storybookjs/storybook91.3KUpdated Oct 22, 2026

See all skills by storybookjs

Report a problem with this skill