# X9 Agent Instructions

> Use when drafting a one-off prompt/task brief for another agent without executing it, or when creating, auditing, or editing global personal agent instructions — «напиши промпт для агента», «мне нужен промпт», «поправь глобальные правила», «обнови CLAUDE.md/AGENTS.md», "write an agent prompt", "edit my global instructions". Do not use for repository onboarding files (x9-context-files-generator),…

- **Type:** Skill
- **Install:** `agentstack add skill-xonika9-agent-skills-x9-agent-instructions`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [xonika9](https://agentstack.voostack.com/s/xonika9)
- **Installs:** 0
- **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [xonika9](https://github.com/xonika9)
- **Source:** https://github.com/xonika9/agent-skills/tree/main/skills/x9-agent-instructions
- **Website:** https://skills.sh/xonika9/agent-skills

## Install

```sh
agentstack add skill-xonika9-agent-skills-x9-agent-instructions
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Agent instructions

Own global behavioral policy in `~/.claude/CLAUDE.md`, `~/.codex/AGENTS.md`, and bounded briefs handed to another agent. Write machine-facing instructions in English; preserve literal user phrases in their original language.

## Classify before editing

Place each rule in the narrowest owner that can reliably enforce it:

- **Stable personal policy:** authority, preservation, uncertainty, completion, communication → mirrored shared core in both global files.
- **Runtime adapter:** current models, tools, CLI flags, browser and subagent schemas → a runtime-specific global section or a user-owned adapter outside the reusable skill.
- **Repository context:** commands and local constraints → repository `AGENTS.md`/`CLAUDE.md`, owned by `x9-context-files-generator`.
- **Domain behavior:** situation-specific method → the relevant skill.
- **Operational state:** rankings, measurements, experiments, freshness dates → a dated state/log file, not standing policy.
- **One-off task:** goal, constraints, evidence, authority, deliverable, and observable completion bar → the task brief.

System and developer instructions remain higher authority than user, repository, or skill instructions. Never write a lower layer as though it can override a higher one.

## Editing contract

1. Read both global files and any runtime adapter affected by the change.
2. Add a standing rule only when omitting it would make a capable agent materially likely to behave differently or repeat a known failure. Do not spend always-loaded context on generic advice the model already follows.
3. Identify the canonical owner. Allow a short audience-specific summary elsewhere only when it changes behavior; point back to the owner.
4. Preserve unrelated user content. Replace only the intended bounded section when markers exist.
5. Keep the shared block between `` and `` byte-identical in both global files.
6. State hard negative boundaries explicitly when safety or preservation depends on them. Prefer positive target behavior for ordinary guidance.
7. Specify process only when the path is part of correctness: dependencies, approval gates, deterministic transformations, state/checkpoints, or known failure modes.
8. Resolve the installed `x9-agent-instructions` directory from the loaded `SKILL.md`, then run `python3 /scripts/check_globals.py`. Do not resolve the script from the caller's current working directory. Exercise the behavior scenarios below; a prose reread alone is not validation.

## Behavior scenarios

- Answer/review request → inspect and report; no edits.
- Explicit build/fix request → safe in-scope local edits and tests proceed; external, destructive, costly, or expanded actions require confirmation.
- Required tool fails → report the failure; no from-memory substitution.
- Runtime fact changes → update one adapter and its freshness marker, not every skill.
- Shared policy changes → both global copies match; runtime-specific sections may differ deliberately.
- One-off brief has a load-bearing ambiguity → ask one question; otherwise proceed with a stated assumption.

## Done

- Every added standing rule changes likely behavior or prevents a documented failure; generic advice was left out.
- The rule has one canonical owner and no accidental contradiction.
- Shared global policy passes `python3 /scripts/check_globals.py` from an unrelated working directory.
- At least one positive and one boundary scenario were checked in a fresh context for substantive changes.
- The handoff names changed files and validation performed.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [xonika9](https://github.com/xonika9)
- **Source:** [xonika9/agent-skills](https://github.com/xonika9/agent-skills)
- **License:** MIT
- **Homepage:** https://skills.sh/xonika9/agent-skills

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-xonika9-agent-skills-x9-agent-instructions
- Seller: https://agentstack.voostack.com/s/xonika9
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.