Agent skill

Artifact Metadata

by jmagly in jmagly/aiwg

Manage artifact metadata, versioning, ownership, and review history across the SDLC lifecycle

MITAuto-check passed

Install Artifact Metadata

skills CLI
$ npx skills add jmagly/aiwg --skill artifact-metadata -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jmagly/aiwg artifact-metadata --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jmagly/aiwg.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agentic/code/plugins/utils/skills/artifact-metadata .claude/skills/artifact-metadata && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
artifact-metadata
GitHub stars
220
Token cost
~1.9k tokens
SKILL.md length
316 words
Files
2 (incl. scripts)
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Manage artifact metadata, versioning, ownership, and review history across the SDLC lifecycle

  • Works in 4 steps: Locates or creates metadata → Updates metadata fields → Tracks history → …
  • SKILL.md covers Triggers, Purpose, Behavior and Metadata Schema, plus 8 more sections
  • Runs Python scripts from its folder; calls python; reaches json-schema.org

What it does

Artifact Metadata is an agent skill from jmagly/aiwg. Manage artifact metadata, versioning, ownership, and review history across the SDLC lifecycle

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/artifact_metadata.py`).

The repository describes itself as: Cognitive architecture for AI-augmented software development. Specialized agents, structured workflows, and multi-platform deployment. Claude Code · Codex · Copilot · Cursor ·… The licence is MIT.

Example prompts

  • “/artifact-metadata”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Locates or creates metadata
  2. Updates metadata fields
  3. Tracks history
  4. Validates relationships

What it can do on your machine

Read from SKILL.md and the folder at commit dda238f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • json-schema.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Artifact Metadata loads about 1.9k tokens when it runs. Until then it costs about 28 tokens; SKILL.md has 316 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~28
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from jmagly/aiwg at commit dda238f, republished under its MIT licence (© jmagly). 316 words, ~1,856 tokens.

Download SKILL.mdSave it as .claude/skills/artifact-metadata/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
artifact-metadata
description
Manage artifact metadata, versioning, ownership, and review history across the SDLC lifecycle
namespace
aiwg
platforms
all

artifact-metadata

Manage artifact metadata, versioning, ownership, and history tracking.

Triggers

Alternate expressions and non-obvious activations (primary phrases are matched automatically from the skill description):

  • "tag this artifact" → metadata tagging
  • "classify [artifact]" → artifact metadata assignment

Purpose

This skill provides consistent metadata management for all SDLC and marketing artifacts. It tracks ownership, versioning, review history, and status across the artifact lifecycle.

Behavior

When triggered, this skill:

  1. Locates or creates metadata:

    • Check for existing metadata.json alongside artifact
    • Create new metadata if none exists
    • Validate against metadata schema
  2. Updates metadata fields:

    • Version (semantic versioning)
    • Status (draft, review, baselined, deprecated)
    • Owner (agent or user)
    • Reviewers (list of reviewing agents)
    • Timestamps (created, modified, baselined)
  3. Tracks history:

    • Version history with change summaries
    • Review records with reviewer and outcome
    • Approval records
  4. Validates relationships:

    • Parent/child artifact links
    • Requirement traceability links
    • Cross-references to related artifacts

Metadata Schema

json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "required": ["artifact_id", "name", "type", "version", "status", "owner"],
  "properties": {
    "artifact_id": {
      "type": "string",
      "description": "Unique identifier (e.g., SAD-001, UC-003)"
    },
    "name": {
      "type": "string",
      "description": "Human-readable artifact name"
    },
    "type": {
      "type": "string",
      "enum": ["requirements", "architecture", "test", "security", "deployment", "marketing", "report"]
    },
    "version": {
      "type": "string",
      "pattern": "^\\d+\\.\\d+\\.\\d+$",
      "description": "Semantic version"
    },
    "status": {
      "type": "string",
      "enum": ["draft", "review", "approved", "baselined", "deprecated"]
    },
    "owner": {
      "type": "string",
      "description": "Primary owner (agent name or user)"
    },
    "created": {
      "type": "string",
      "format": "date-time"
    },
    "modified": {
      "type": "string",
      "format": "date-time"
    },
    "baselined": {
      "type": "string",
      "format": "date-time"
    },
    "reviewers": {
      "type": "array",
      "items": {"type": "string"}
    },
    "history": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "version": {"type": "string"},
          "date": {"type": "string", "format": "date-time"},
          "author": {"type": "string"},
          "summary": {"type": "string"}
        }
      }
    },
    "reviews": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "reviewer": {"type": "string"},
          "date": {"type": "string", "format": "date-time"},
          "outcome": {"type": "string", "enum": ["approved", "conditional", "rejected"]},
          "comments": {"type": "string"}
        }
      }
    },
    "traceability": {
      "type": "object",
      "properties": {
        "requirements": {"type": "array", "items": {"type": "string"}},
        "parent": {"type": "string"},
        "children": {"type": "array", "items": {"type": "string"}}
      }
    },
    "tags": {
      "type": "array",
      "items": {"type": "string"}
    }
  }
}

Usage Examples

Create New Metadata
User: "Create metadata for the SAD"

Skill creates:
.aiwg/architecture/sad/metadata.json
{
  "artifact_id": "SAD-001",
  "name": "Software Architecture Document",
  "type": "architecture",
  "version": "0.1.0",
  "status": "draft",
  "owner": "architecture-designer",
  "created": "2025-12-08T14:30:00Z",
  "modified": "2025-12-08T14:30:00Z",
  "reviewers": [],
  "history": [],
  "reviews": []
}
Update Version After Changes
User: "Version the SAD to 1.0.0 with summary 'Initial baseline'"

Skill updates:
- version: "1.0.0"
- status: "baselined"
- baselined: "2025-12-08T16:45:00Z"
- history: [adds entry with version, date, summary]
Record Review
User: "Record security-architect review as approved"

Skill updates:
- reviews: [adds review record]
- reviewers: [adds "security-architect" if not present]
- modified: [updates timestamp]
Query Ownership
User: "Who owns the test plan?"

Skill responds:
"Test Plan (TP-001) is owned by test-architect.
Status: review
Version: 0.3.0
Last modified: 2025-12-07
Reviewers: security-auditor, requirements-analyst"

Status Lifecycle

draft → review → approved → baselined
  ↑        ↓
  └── rejected (returns to draft)

baselined → deprecated (end of life)
Status Transitions
FromToTriggered By
draftreviewSubmit for review
reviewapprovedAll reviewers approve
reviewdraftAny reviewer rejects
approvedbaselinedFormal baseline action
baselineddeprecatedSuperseded or retired

Version Conventions

  • 0.x.x: Draft versions (not baselined)
  • 1.0.0: First baseline
  • x.y.0: Minor changes (compatible)
  • x.0.0: Major changes (may break traceability)
Auto-Version Rules
Change TypeVersion Bump
Typo fixpatch (0.0.x)
Section updateminor (0.x.0)
Structure changemajor (x.0.0)
Initial baseline1.0.0

Artifact Type Conventions

TypeID PrefixLocation
requirementsUC-, REQ-, NFR-.aiwg/requirements/
architectureSAD-, ADR-, API-.aiwg/architecture/
testTP-, TC-, TS-.aiwg/testing/
securityTM-, SEC-.aiwg/security/
deploymentDP-, RN-.aiwg/deployment/
marketingCB-, CA-.aiwg/marketing/
reportRPT-.aiwg/reports/

CLI Usage

bash
# Create metadata for artifact
python artifact_metadata.py --create --artifact ".aiwg/architecture/sad.md" --type architecture

# Update version
python artifact_metadata.py --version "1.0.0" --artifact ".aiwg/architecture/sad.md" --summary "Initial baseline"

# Record review
python artifact_metadata.py --review --artifact ".aiwg/architecture/sad.md" \
  --reviewer "security-architect" --outcome "approved" --comments "LGTM"

# Query metadata
python artifact_metadata.py --query --artifact ".aiwg/architecture/sad.md"

# List all artifacts by status
python artifact_metadata.py --list --status "review"

# Validate all metadata
python artifact_metadata.py --validate-all

Integration

This skill integrates with:

  • artifact-orchestration: Sets initial metadata when creating artifacts
  • gate-evaluation: Checks artifact status for gate criteria
  • traceability-check: Uses traceability links in metadata
  • template-engine: Copies metadata template on instantiation

Output Locations

  • Metadata file: {artifact-dir}/metadata.json
  • Alternatively: {artifact-dir}/{artifact-name}.metadata.json
  • Index file: .aiwg/reports/artifact-index.json

References

  • Schema: schemas/artifact-metadata.schema.json
  • Conventions: AIWG Artifact Naming Guide

© jmagly, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in agentic/code/plugins/utils/skills/artifact-metadata of jmagly/aiwg.

  • SKILL.md
  • scripts/artifact_metadata.py

Open the folder on GitHubat commit dda238f

Compare with similar skills

Artifact Metadata next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Artifact Metadata compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Artifact Metadata this skilljmagly/aiwg220—~1.9kAutomated safety check: PassMIT
Extracting Browser History Artifactsmukul975/Anthropic-Cybersecurity-Skills34k—~2.9kAutomated safety check: WarnApache-2.0
Artifacts Buildernexu-io/open-design100k—~347Automated safety check: PassApache-2.0
Web Artifacts Builderanthropics/skills180k41 repos~769Automated safety check: PassApache-2.0
Web Artifacts Buildernexu-io/open-design100k—~337Automated safety check: PassApache-2.0
Managing Endpoint VersionsPostHog/posthog40k—~2.3kAutomated safety check: PassCustom licence

Similar skills

  • Extracting Browser History Artifacts

    mukul975/Anthropic-Cybersecurity-Skills

    Extracts and analyzes browser history, cookies, cache, downloads, and bookmarks from Chrome, Firefox, and Edge using sqlite3, DB Browser for SQLite, Hindsight, and NirSoft tools…

    34k GitHub stars~2.9k tokensUpdated 1 mo ago
    SecurityAuto-check: warnings
  • Artifacts Builder

    nexu-io/open-design

    Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui).

    100k GitHub stars~347 tokensUpdated today
    Frontend & DesignAuto-check passed
  • Web Artifacts Builder

    anthropics/skills

    Official

    Builds multi-component claude.ai HTML artifacts as a small React, TypeScript and Tailwind project, then bundles it into one shareable HTML file.

    180k GitHub starsUsed in 41 repos~769 tokens
    Frontend & DesignAuto-check passed
  • Web Artifacts Builder

    nexu-io/open-design

    Build complex claude.ai HTML artifacts with React and Tailwind.

    100k GitHub stars~337 tokensUpdated today
    Frontend & DesignAuto-check passed
  • Official

    Work safely with endpoint versions — preview a draft in the playground, roll back to an older version, update settings on one version without bumping query history, deactivate a specific version.

    40k GitHub stars~2.3k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Web Artifacts Builder

    sickn33/agentic-awesome-skills

    To build powerful frontend claude.ai artifacts, follow these steps:

    47k GitHub starsUsed in 3 repos~824 tokens
    Frontend & DesignAuto-check passed

More from jmagly/aiwg

All 11 skills in this repo
  • Review editorial phrase patterns and suggest contextual alternatives; legacy name does not imply authorship detection.

    220 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Voice Apply

    jmagly/aiwg

    Apply a voice profile to transform content. An agent skill from jmagly/aiwg.

    220 GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Mutation Test

    jmagly/aiwg

    Run mutation testing to validate test quality beyond code coverage.

    220 GitHub stars~3.2k tokensUpdated today
    Auto-check passed
  • TDD Enforce

    jmagly/aiwg

    Configure TDD enforcement via pre-commit hooks and CI coverage gates.

    220 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Detect project type, AIWG framework state, team configuration, and active work to summarize status and recommend next actions

    220 GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Banned API Audit

    jmagly/aiwg

    Scan source code for banned APIs/forbidden functions per project banlist; report violations with paths, line numbers, and recommended replacements

    220 GitHub stars~2.2k tokensUpdated today
    Auto-check passed

Questions about Artifact Metadata

What does Artifact Metadata do?

Manage artifact metadata, versioning, ownership, and review history across the SDLC lifecycle. Artifact Metadata is an agent skill from jmagly/aiwg.

How do I install Artifact Metadata in Claude Code?

Run `npx skills add jmagly/aiwg --skill artifact-metadata -a claude-code`. Or copy the skill folder (agentic/code/plugins/utils/skills/artifact-metadata in jmagly/aiwg) into .claude/skills/artifact-metadata in your project. Claude Code loads it when a task matches its description.

How do I install Artifact Metadata in Codex?

Run `npx skills add jmagly/aiwg --skill artifact-metadata -a codex`. Or copy the skill folder (agentic/code/plugins/utils/skills/artifact-metadata in jmagly/aiwg) into .agents/skills/artifact-metadata in your project. Codex loads it when a task matches its description.

Can I use Artifact Metadata in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jmagly/aiwg --skill artifact-metadata -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/artifact-metadata, .gemini/skills/artifact-metadata, .github/skills/artifact-metadata and .opencode/skills/artifact-metadata in your project.

What does Artifact Metadata need to run?

Going by SKILL.md and its folder, Artifact Metadata needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Artifact Metadata access the network?

SKILL.md names 1 domain. In commands or code: json-schema.org; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Artifact Metadata safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Artifact Metadata use?

Artifact Metadata is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Artifact Metadata use?

About 1.9k tokens (SKILL.md is roughly 7.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Artifact Metadata?

Skills that share tags, products or a category with Artifact Metadata: Extracting Browser History Artifacts (mukul975/Anthropic-Cybersecurity-Skills, 34k stars), Artifacts Builder (nexu-io/open-design, 100k stars), Web Artifacts Builder (anthropics/skills, 180k stars) and Web Artifacts Builder (nexu-io/open-design, 100k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Artifact Metadata?

jmagly (a GitHub user) maintains it in jmagly/aiwg, which has 220 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 8, 2026.

Source: jmagly/aiwg on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.