worklog-manager

Bootstrap and audit Codex worklog metadata under .agents/worklog/codex.

142|5|Updated Dec 26, 2015
One-click install
npx skills add https://github.com/shunk031/dotfiles --skill worklog-manager
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: worklog-manager
Source: https://github.com/shunk031/dotfiles/tree/main/home/dot_config/exact_agents/skills/worklog-manager
Command: npx skills add https://github.com/shunk031/dotfiles --skill worklog-manager

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill helps bootstrap and manage Codex worklog context under .agents/worklog/codex, ensure the learn_index.md startup state is initialized, and audit the consistency of learn metadata before trusting prior sessions.

Core Features & Use Cases

  • Bootstraps or updates .agents/worklog/codex/{plan,todo,learn} directories.
  • Validates and audits learn_index.md and per-learn metadata.
  • Provides deterministic startup summaries for active learnings and detects drift_prone entries.

Quick Start

Run the startup audit to bootstrap and validate .agents/worklog/codex context from the learn index.

Frequently Asked Questions about worklog-manager

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I bootstrap Codex worklog context for plan, todo, and learn directories?▼

To bootstrap Codex worklog context, initialize the .agents/worklog/codex/{plan,todo,learn} directories. This skill automates that setup and validates the learn_index.md startup state to ensure a consistent baseline for new sessions.

Why does my learn metadata fail consistency checks before trusting prior sessions?▼

Learn metadata fails consistency checks when frontmatter is missing required fields like status, freshness, or last_validated_at. This skill audits learn entries and enforces these requirements to detect drift-prone entries before you trust prior sessions.

What is the best way to audit learn_index.md for index and file coherence?▼

The best way to audit learn_index.md coherence is running the provided audit script. It validates per-learn metadata, checks frontmatter requirements including review_after when applicable, and ensures index/file coherence across .agents/worklog/codex.

Can I detect drift-prone entries in my Codex worklog learn metadata?▼

Yes, you can detect drift-prone entries by running a startup audit. The skill generates deterministic startup summaries for active learnings and flags entries that lack required frontmatter or fail consistency validation against the learn index.

Do I need any dependencies to validate learn metadata frontmatter requirements?▼

No dependencies are required to validate learn metadata frontmatter. The skill operates independently using bundled scripts and references to enforce required fields like status, freshness, and last_validated_at across your worklog entries.

What limitations exist when bootstrapping worklog context for prior sessions?▼

When bootstrapping worklog context, the main limitation is trusting prior sessions without auditing. The skill requires valid frontmatter and index/file coherence; entries missing review_after or last_validated_at are flagged as drift-prone and cannot be trusted automatically.