The Elements of Agent Style: a literature-backed English technical-prose writing ruleset for AI agents, with CLI install/enable/disable for 8 primary agent surfaces.
Project description
agent-style (PyPI)
CLI for The Elements of Agent Style: a literature-backed English technical-prose writing ruleset for AI agents.
Install:
pip install agent-style
Basic use:
agent-style list-tools # show supported tools
agent-style enable claude-code # wire up Claude Code
agent-style enable claude-code --dry-run --json # preview in canonical JSON
agent-style disable claude-code # reverse
agent-style rules # print bundled RULES.md
The CLI writes to .agent-style/ in your project and safely adds a marker-wrapped reference to your existing instruction file (CLAUDE.md, AGENTS.md, .github/copilot-instructions.md, etc.). Existing content is preserved; writes are idempotent; --dry-run previews without changing any file.
Supported tools and install modes in v0.1.0:
| Tool | Install mode |
|---|---|
| claude-code | import-marker (writes @.agent-style/claude-code.md to your CLAUDE.md) |
| agents-md | append-block (writes a marker block to your AGENTS.md) |
| copilot | append-block (writes a marker block to .github/copilot-instructions.md) |
| copilot-path | owned-file (writes .github/instructions/agent-style.instructions.md) |
| cursor | owned-file (writes .cursor/rules/agent-style.mdc) |
| anthropic-skill | owned-file (writes .claude/skills/agent-style/SKILL.md) |
| codex | print-only (writes .agent-style/codex-system-prompt.md; stdout = prompt) |
| aider | multi-file-required (writes .agent-style/aider-conventions.md; stderr = .aider.conf.yml snippet) |
The full rule set lives in the canonical repository at https://github.com/yzhao062/agent-style. This PyPI package bundles RULES.md, NOTICE.md, the 8 primary adapters, and the tools.json registry; running agent-style rules prints the bundled RULES.md for quick review.
License
- Code: MIT (
LICENSES/MIT.txt). - Bundled prose (
RULES.md,NOTICE.md, adapters): CC BY 4.0 (LICENSES/CC-BY-4.0.txt).
Roadmap (v0.2.0+): agent-style update (pull refreshed adapters), agent-style override <RULE> disable (per-rule opt-out), agent-style clean (single-command uninstall), .agent-style/config.toml (project-level config).
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agent_style-0.1.0.tar.gz.
File metadata
- Download URL: agent_style-0.1.0.tar.gz
- Upload date:
- Size: 51.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4917482ae19e1b8be785234024f15a6bc67e08a743aa6a2a3fc614b451283e67
|
|
| MD5 |
a5165fa9cc11fe707d4940b86b4b88c0
|
|
| BLAKE2b-256 |
c6e71ac79accfb08bff1f2efbea15072aa99ab3cbf7f2011fee1e2c5aeeeb131
|
File details
Details for the file agent_style-0.1.0-py3-none-any.whl.
File metadata
- Download URL: agent_style-0.1.0-py3-none-any.whl
- Upload date:
- Size: 66.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2a58c9c987d822115db745a863f6c5cfb9ae87bb16b99f722dc1f7003f7c3988
|
|
| MD5 |
e6db5d12cf15640f0972440aff953b86
|
|
| BLAKE2b-256 |
eec8ed3a6fefc7a7d0cce6232f1836ec9b29e8771da9f20ce04f705a706adb33
|