# Gather Project Metadata

> Use when creating research or plan documents to gather git commit, branch, repository info.

- Skill: `tomevault-io/gather-project-metadata` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/gather-project-metadata`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/gather-project-metadata/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/gather-project-metadata

---


# Gather Project Metadata

Collect metadata for documentation frontmatter.

## What to Gather

- Current timestamp (ISO format with timezone)
- Git commit hash
- Git branch name
- Repository name
- Project name (from directory or package.json)
- Feature slug (if in feature directory context)

## How to Gather

Run the metadata collection script:

```bash
~/.claude/scripts/collect-metadata.sh
```

Or gather manually:

```bash
# Timestamp
date -u +"%Y-%m-%dT%H:%M:%SZ"

# Git info
git rev-parse HEAD
git rev-parse --abbrev-ref HEAD
git remote get-url origin | sed 's/.*[:/]\(.*\)\.git/\1/'

# Project name
basename $(pwd)

# Feature slug (if applicable)
FEATURE_DIR=$(pwd | grep -oE 'thoughts/[0-9]{4}-[^/]+' || echo "")
if [ -n "$FEATURE_DIR" ]; then
    basename "$FEATURE_DIR"
fi
```

## Usage in Documents

Insert gathered metadata into frontmatter:

```yaml
---
date: 2025-12-23T10:30:00Z
git_commit: abc123...
branch: main
repository: github.com/eveld/claude
---
```

## Template Variables

When using templates, replace these placeholders:
- `{ISO_TIMESTAMP}` - ISO 8601 timestamp
- `{GIT_COMMIT}` - Full commit hash
- `{BRANCH_NAME}` - Current branch
- `{REPOSITORY}` - Repository path
- `{PROJECT_NAME}` - Project name
- `{DATE}` - Simple date (YYYY-MM-DD)
- `{FEATURE_SLUG}` - Feature slug (e.g., "0005-authentication")

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/eveld) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->