القائمة
Author SYSTEM.md or APPEND_SYSTEM.md for pi coding agent. Use when extending the default system prompt with custom principles, guidelines, or project rules.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | pi-prompt-authoring |
| topic | Pi Prompt Authoring |
| description | Author SYSTEM.md or APPEND_SYSTEM.md for pi coding agent. Use when extending the default system prompt with custom principles, guidelines, or project rules. |
| token_cost | 350 |
| keywords | ["prompt","system","guideline","rule","principle","authoring"] |
Authors custom system prompt additions for pi coding agent. Pi provides a default system prompt with identity, tools, and guidelines. This skill covers what to add via SYSTEM.md (replace default) or APPEND_SYSTEM.md (extend default).
Pi builds the system prompt dynamically: identity → tools → guidelines → docs → append → context → skills → metadata.
SYSTEM.md replaces the default. APPEND_SYSTEM.md extends it.
Locations: .pi/SYSTEM.md (project), ~/.pi/agent/SYSTEM.md (global), or --system-prompt (CLI).
See detailed prompt structure for full construction order, tool listing, skills format, and context file loading.
Define coding standards and architectural preferences. Common categories: simplicity, code quality, codebase health, build verification, security.
See example principles for working examples.
Enforce specific behaviors: debugging, architecture, testing, scope, error handling, documentation, user directives.
See example guidelines for working examples.
Add usage patterns for custom tools from extensions. Built-in tools are auto-documented.
See example tool guidelines for working examples.
Add project conventions not covered by AGENTS.md/CLAUDE.md.
See example project context for working examples.
Use APPEND_SYSTEM.md for extensions: Don't replace pi's default unless necessary. Append custom principles to preserve built-in functionality.
Use SYSTEM.md for replacements: Only if you need to fundamentally change pi's behavior.
XML tags for organization: Use <section_name> tags to organize principles logically.
Concise, value-based rules: "Scope is sacred" not "When asked to do X, only touch files that Y".
No procedural details: Avoid code snippets, variable names, or step-by-step scenarios.
Before finalizing:
SYSTEM.md (replace) or APPEND_SYSTEM.md (extend)Renders markdown to self-contained HTML with a custom dark stylesheet and opens in browser. Use when previewing markdown documents, generating styled HTML from README or report files.
Inform the user what is happening — skip passive lookups
Manage version control with Jujutsu (jj) — no staging area, immediate changes, smart rebasing. Use when navigating history, squashing, or pushing to Git remotes.
Programmatic hunk selection for Jujutsu — split, commit, or squash specific hunks without interactive prompts. Use when making partial commits or selective squashes.
Gather facts from the web using evidence-first approach with mandatory citations. Use when researching topics, answering factual questions, or any task requiring web-sourced evidence.
Model minimum-move problems as BFS over a state space. Use when solving bucket pouring puzzles, sliding tiles, or any problem asking for the shortest sequence of moves to reach a goal.