Menu
Use this skill when you need to read ticket artifacts like refinement.md, architecture.md, or specification.md.
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
| name | potato:read-artifacts |
| description | Use this skill when you need to read ticket artifacts like refinement.md, architecture.md, or specification.md. |
Use the MCP tools. Don't construct paths. Don't search.
list_artifacts - See what artifacts existget_artifact - Get content and metadata by filename# List what's available
list_artifacts
โ { "artifacts": [{ "filename": "refinement.md", ... }] }
# Get specific artifact
get_artifact({ "filename": "refinement.md" })
โ { "filename": "refinement.md", "content": "...", ... }
use the skill: potato:notify-user to announce:
"[Your Agent Name]: I found the following artifact and will read it as a part of my context."
| Artifact | Phase | Description |
|---|---|---|
refinement-draft.md | Refinement | Initial requirements (may have gaps) |
refinement.md | Refinement | Approved requirements |
architecture-draft.md | Architecture | Initial technical design |
architecture.md | Architecture | Approved technical design |
specification.md | Specification | Final spec with tasks |
| Thought | Reality |
|---|---|
| "Let me construct the path" | Use get_artifact instead |
| "Let me search for refinement.md" | Use list_artifacts to see what exists |
| "I'll use the Read tool" | Use get_artifact - it handles paths |
| "Maybe it's in ~/.potato-cannon/" | MCP tools abstract storage location |
list_artifacts and get_artifactlist_artifacts if unsure what existsUse this skill to add comments or notes to an existing task. Comments help track progress, document decisions, or explain issues.
You MUST use this anytime you want to ask the user a question or feel like something is unclear. If you think you want to use the AskUserQuestion tool, first invoke this skill, we may have a different way of asking the user a question.
You MUST use this skill in order to create, update, edit, or build artifacts or files. Artifacts can be of any type but are typically markdown files.
Use this skill to create a new task for tracking work within the current ticket. Tasks help break down work into smaller trackable units.
Use this skill to create a new ticket in the current project. Use this to convert a brainstorm into a formal ticket for tracking development work.
Use this skill to retrieve details of a specific task by its ID. Returns the task's description, status, comments, and other metadata.