Repository preparation / agent skill
Help people understand, run and contribute to your project. Let Them See It inspects the repository, proposes concrete improvements, and implements the changes you approve.
Concrete examples
Illustrative situations and proposed improvements, not measured results or executed case studies.
Before
“Run the app.” No prerequisites, configuration or working command.
After approval
Document the actual prerequisites and commands. Check the quickstart in a fresh disposable clone where feasible; report anything untested.
Before
Source, cached output and internal notes share the root. Nobody knows which files matter.
After approval
Organize around real build and packaging paths, trace affected callers and verify the shipped contents. Preserve unrelated work.
Before
The English README has the new install command; translated guides still show the old one.
After approval
Agree on languages and paths, align commands, links and coverage, and disclose translations without fluent review.
Before
A deleted file contains a possible credential. The current tree looks clean.
Expected boundary
Flag historical exposure without revealing the value. Block publication on unresolved sensitive findings; recommend revocation or rotation.
The workflow
Trace installation and usage. Evaluate documentation, structure, sensitive content, licensing and useful checks without editing.
Review a prioritized plan with file evidence and acceptance checks. Existing explicit authorization remains valid.
Apply the agreed changes. Report verified checks, limitations, open decisions and publication status separately.
Preparation is not permission to publish. Pushes, releases and external posts require authorization.
Install & use
You need Git and an agent that supports SKILL.md skills. For the default Codex setup, clone into an unused skill directory:
git clone https://github.com/pengusto/let-them-see-it.git ~/.codex/skills/let-them-see-itUse your configured skill location if it differs. Start a new agent session if the skill is not yet listed, then ask:
Use $let-them-see-it to evaluate this repository for public release. Show me the proposed changes before editing anything.
The skill itself requires no runtime packages or API keys. GitHub access and project tools are needed only for actions that use them.
Know the limits
This is an instruction-based workflow, not an automated security certification. Scanner availability and agent behavior vary. A passing schema or link check does not prove safe content or correct behavior.
License and asset-rights uncertainties need a maintainer decision. The eight existing README translations are AI-produced and have not received independent fluent review. The skill promises no stars, virality or GitHub Trending placement.