Skip to content
artifact-tracking logo

Artifact Tracking Skill

artifact-tracking

Token-efficient tracking for AI orchestration. CLI-first for status updates (~50 tokens), agent fallback for complex ops (~1KB). Use when: updating task status, querying blockers, creating progress files, validating phases.

SKILL.md

Full skill instructions

Artifact Tracking Skill

Token-efficient tracking artifacts for AI agent orchestration.

Quick Operations (CLI First)

OperationCommandTokens
Mark completepython scripts/​update-status.py -f FILE -t TASK-X -s completed~50
Batch updatepython scripts/​update-batch.py -f FILE --updates "T1:completed,T2:completed"~100
Query pendingpython scripts/​query_artifacts.py --status pending~50
Validatepython scripts/​validate_artifact.py -f FILE~50

Scripts location: .claude/​skills/​artifact-tracking/​scripts/

Agent Operations (When Needed)

For complex operations requiring judgment:

OperationAgentWhen to Use
CREATE fileartifact-trackerNew phase, need template
UPDATE complexartifact-trackerBlockers with context, decisions
QUERY synthesisartifact-queryCross-phase analysis, handoffs
VALIDATE qualityartifact-validatorPre-completion checks

Agent invocation:

Task("artifact-tracker", "Create Phase 2 progress for auth-overhaul PRD")
Task("artifact-query", "Show all blocked tasks in auth-overhaul phases 1-3")

File Locations

TypeLocationLimit
Progress.claude/​progress/[prd]/​phase-N-progress.mdONE per phase
Context.claude/​worknotes/[prd]/​context.mdONE per PRD
Bug fixes.claude/​worknotes/​fixes/​bug-fixes-YYYY-MM.mdONE per month
Observations.claude/​worknotes/​observations/​observation-log-MM-YY.mdONE per month

Policy: .claude/​specs/​doc-policy-spec.md

YAML Format (Source of Truth)

---
type: progress
prd: "prd-name"
phase: 2
status: in_progress
progress: 40

tasks:
  - id: "TASK-2.1"
    status: "pending"           # pending|in_progress|completed|blocked
    assigned_to: ["agent-name"] # REQUIRED for orchestration
    dependencies: []            # REQUIRED for orchestration
    model: "opus"               # Optional: opus|sonnet|haiku

parallelization:
  batch_1: ["TASK-2.1", "TASK-2.2"]  # Run parallel
  batch_2: ["TASK-2.3"]              # After batch_1
---

Token Efficiency

OperationTraditionalOptimizedSavings
Task list25KB2KB92%
Query blockers75KB3KB96%
Status update25KB50 bytes99.8%

Detailed References

  • Creating files: ./​creating-artifacts.md
  • Updating tasks: ./​updating-artifacts.md
  • Querying data: ./​querying-artifacts.md
  • Validating: ./​validating-artifacts.md
  • Orchestration: ./​orchestration-reference.md
  • Best practices: ./​best-practices.md
  • Common patterns: ./​common-patterns.md
  • Format spec: ./​format-specification.md
  • Templates: ./​templates/
  • Schemas: ./​schemas/

More Other skills

Delegate independent tasks to specialized agents working concurrently with isolated context.

295.4K 206.3K
View

Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.

179.7K 100.1K
View

Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.

179.7K 89.5K
View

A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).

179.7K 76.1K
View

Fundamental design principles for writing maintainable, testable Python code.

40.2K 21.9K
View

Modern responsive layouts using container queries, fluid typography, CSS Grid, and mobile-first strategies.

40.2K 20K
View

Generate Playwright tests from scenarios using interactive browser exploration and validation.

39.7K 18.2K
View

Modern React state management with Redux Toolkit, Zustand, Jotai, and React Query for every state category.

40.2K 14.7K
View

GDPR-compliant data handling with consent management, data subject rights, and privacy controls.

40.2K 14.3K
View

Python error handling patterns including input validation, exception hierarchies, and partial failure handling. Use when implementing validation logic, designing exception strategies, handling batch processing failures, or building robust APIs.

40.2K 13.5K
View

Detailed multi-file refactor planning with safety checks and rollback guidance.

39.7K 13K
View