메뉴
Write content to a timestamped markdown file. Use when agents need to save plans, reviews, or other outputs.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
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/ |