agentleFS
FirzusFirzus/agent-skills/skills/engineering/setup-harness/SKILL.md

setup-harness

Skill4 starsChanged 20 days agoMITView on GitHub

Set up personal instructions for Codex (app and CLI), Cursor, or Claude Code, with reviewed content, native instruction loading, and no backups or system-prompt replacement.

2 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

10 rules. About 0 are common, 9 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈9

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Create or update personal instructions through each selected harness's native mechanism.

    line 9
  2. Distinctive:

    Ask which harness or harnesses to configure.

    line 17
  3. Very specific:

    Ask for the languages used for conversation/reports and code/comments/Git text.

    line 24
  4. Distinctive:

    If its instruction mechanism is unknown, leave that harness pending while working on the others.

    line 32
  5. Distinctive:

    Read each existing destination and relevant instruction sources.

    line 39
  6. Distinctive:

    Read the policy template to draft the shared policy.

    line 46
  7. Distinctive:

    Keep harness-specific loading details out of the installed policy.

    line 49
  8. Distinctive:

    Wait for explicit approval of the content and actions for each destination.

    line 53
  9. Distinctive:

    If any operation fails, inspect its actual result before retrying.

    line 79
  10. Distinctive:

    If an existing override or conflicting rule affects loading, report the limitation without changing that source or claiming the new …

    line 92

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Set up personal harness instructions

Create or update personal instructions through each selected harness's native mechanism. Keep its built-in system prompt intact. This skill changes only the selected instruction destinations, leaving configuration and legacy files unchanged. It requires file-editing access for file targets; no installer or PowerShell dependency.

1. Select harnesses and languages

Ask which harness or harnesses to configure. Offer Codex, Cursor, and Claude Code; reuse selections already explicit in this request rather than asking again. Codex is one choice covering the app and CLI, which share user instructions under the same CODEX_HOME. The current host is not an implicit selection. Confirm the machine/profile when it affects the destination. Default to personal, cross-project scope.

Ask for the languages used for conversation/reports and code/comments/Git text. One answer may cover both; reuse explicit choices made for this setup. Do not infer permanent preferences from the chat's language.

For each selected harness, read its section in native destinations to resolve supported loading and existing instruction conflicts. For an unlisted harness, verify its official documentation before proposing a destination. If its instruction mechanism is unknown, leave that harness pending while working on the others; do not invent a global AGENTS.md path.

Done: selected harnesses, languages, scope, and exact destinations are known.

2. Inspect and prepare the proposal

  1. Read each existing destination and relevant instruction sources. Preserve unrelated content and identify conflicts instead of replacing whole files with a template. Record a content hash, or absence, for each target; for UI rules, retain the current text in the conversation for comparison.
  2. Resolve symbolic links or junctions before proposing a write. Show the real destination and obtain approval for that target rather than writing through a link silently. A directory where a file is expected blocks that target.
  3. Read the policy template to draft the shared policy. Substitute the two language placeholders and adapt only approved preferences. Reconcile existing policy sections rather than appending duplicates. Keep harness-specific loading details out of the installed policy.
  4. Present the complete proposed text or diff and each exact destination. Explain material removals within the instruction text, unresolved conflicts, and the supported loading mechanism. State that setup creates no backups.
  5. Wait for explicit approval of the content and actions for each destination. General setup authorization is not approval of unseen text. If declined, revise the proposal or leave that target unchanged. No preview files are written into harness profiles or repositories before approval.

Done: the user approves the exact content and destinations. Waiting: retain proposals in the conversation; independent approved targets may proceed without treating silence as approval for the others.

3. Apply without backups

Re-read every target immediately before editing. If its content, existence, or resolved path changed since review, reconcile and obtain renewed approval. Create missing parent directories only for approved file targets. Write only the approved content using available editing tools, without .bak files, backup directories, or copies of previous versions. An identical destination is a no-op.

For Cursor User Rules, use an available authorized UI integration. If it is not available, provide the exact approved text and destination for the user to apply; report this as pending, not installed. Do not edit undocumented application storage or substitute a project-scoped file for global instructions.

Apply each distinct instruction destination once. Codex's app and CLI do not require separate writes when they share CODEX_HOME. Leave configuration, old policy files, rules outside the selected destination, and backup archives untouched.

If any operation fails, inspect its actual result before retrying. Report which destinations changed and which remain pending; do not automatically roll back other successful targets. With no backups, reversal needs a new reviewed edit, not a promised restore command.

Done: approved targets match the proposal, or partial results are explicitly identified with the failed operation and next safe action.

4. Verify and hand over

  • Compare each written file or saved rule with the approved content. Check language substitutions, preserved instructions, duplicate policy sections, and the absence of new backup artifacts. Check that no unrelated configuration was changed.
  • If an existing override or conflicting rule affects loading, report the limitation without changing that source or claiming the new instructions are active.
  • Report per harness: exact destination, created/updated/unchanged/pending status, unresolved conflicts, and file-level versus runtime verification.
  • With separate authorization, verify loading in a fresh session using the selected client's available instruction/context diagnostics. Otherwise ask the user to start one and mark loading unverified. A file write or an agent's self-report is not proof of loading or behavioral compliance.

Done: requested changes are verified at the available level and remaining manual actions or runtime checks are explicit. Maintaining this skill does not authorize configuring the maintainer's active profile; use temporary profiles for any write tests.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.