Menu
Write content to a timestamped markdown file. Use when agents need to save plans, reviews, or other outputs.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Google-style docstring conventions for Python code. Apply when writing or reviewing functions, classes, or modules that need documentation.
Python naming conventions for this codebase. Apply when writing or reviewing Python code including functions, classes, variables, and constants.
Python type hint conventions for this codebase. Apply when writing or reviewing Python code that needs type annotations on functions, classes, or variables.
Essential Pythonic idioms and conventions. Apply when writing or reviewing Python code to ensure idiomatic patterns like comprehensions, built-in functions, context managers, and unpacking.
Python code organization conventions for this codebase. Apply when structuring modules, organizing imports, designing file layouts, or moving functions/classes within or between files. Use PROACTIVELY when users request to check code organization, move code, or clean up and reorganize a module.
Refactoring complex functions into smaller, pure helper functions. Apply when function complexity is exceeded or when extracting helper functions during refactoring. If tasked with fixing ruff lint errors related to complexity, ALWAYS trigger this skill.
| name | write-markdown-output |
| description | Write content to a timestamped markdown file. Use when agents need to save plans, reviews, or other outputs. |
| user-invocable | true |
| argument-hint | <-s "scope" -o "output-dir"> |
Write content to a markdown file with a UTC timestamp in the filename.
| Input | Description |
|---|---|
stdin | Markdown content (always read from stdin; use a heredoc) |
-s, --scope | Scope/title for the filename (e.g., "sql-validation-plan") |
-o, --output-dir | Output directory path |
Files are written to: <output-dir>/<timestamp>-<scope>.md
| Format | Example |
|---|---|
| Timestamp | 2026-02-02T025204Z |
| Full path | .claude/agent-outputs/plans/2026-02-02T025204Z-sql-validation-plan.md |
Pass content via a bash heredoc. The single-quoted delimiter <<'CONTENT_EOF' prevents all shell interpolation, making backticks, dollar signs, quotes, and other special characters completely safe. Content is always read from stdin:
uv run .claude/scripts/write_markdown_output.py -s "scope-name" -o ".claude/agent-outputs/plans" <<'CONTENT_EOF'
# Your Markdown Content
Code with `backticks`, $variables, "double quotes", and 'single quotes' are all safe.
CONTENT_EOF
| Code | Meaning |
|---|---|
| 0 | File written successfully |
| 1 | Error writing file |
| 2 | Usage error (missing arguments) |
On success, prints the full path to the created file:
[WRITTEN] .claude/agent-outputs/plans/2026-02-02T025204Z-sql-validation-plan.md
| Content Type | Directory |
|---|---|
| Plans | .claude/agent-outputs/plans/ |
| Reviews | .claude/agent-outputs/reviews/ |
| PR Descriptions | .claude/agent-outputs/pr-descriptions/ |