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.