capture-work-guidance

Document completed work and decisions using /docent:tell entries.

Updated Oct 11, 2025
One-click install
npx skills add https://github.com/tnez/docent --skill capture-work-guidance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: capture-work-guidance
Source: https://github.com/tnez/docent/tree/main/skills/docent/capture-work-guidance
Command: npx skills add https://github.com/tnez/docent --skill capture-work-guidance

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

AI agents often complete tasks without adequately documenting their work, leading to knowledge gaps and repeated effort. This Skill provides comprehensive guidance for AI agents on when and how to proactively capture documentation using /docent:tell, transforming ephemeral work into persistent, searchable knowledge.

Core Features & Use Cases

  • 5 Critical Moments: Teaches agents to capture documentation after completing work, making decisions, discovering insights, encountering blockers, and at natural breakpoints.
  • Effective Capture Patterns: Guides agents on writing specific, context-rich documentation that explains "why" decisions were made.
  • Anti-Pattern Avoidance: Helps agents avoid common documentation pitfalls like "I'll document it later" or assuming context is obvious.
  • Use Case: Your AI agent is developing a new feature. This Skill ensures it automatically documents every key decision, insight, and completion, creating a rich, persistent working memory that allows seamless context switching and future reference.

Quick Start

Explain how to proactively capture documentation using /docent:tell.

Frequently Asked Questions about capture-work-guidance

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

FAQPage Schema
How do I capture work documentation as an AI agent completes tasks?

Proactive documentation captures work using `/docent:tell` at critical moments: after completing tasks, making decisions, discovering insights, hitting blockers, and at natural breakpoints. This creates persistent, searchable knowledge that persists across sessions instead of losing context when work ends.

When should I document work and decisions during a project?

Document at five critical moments: task completion, key decisions, valuable insights discovered, blockers encountered, and natural workflow breakpoints. Capturing at these specific points ensures context-rich rationale is preserved rather than forgotten, preventing repeated effort and knowledge gaps.

What makes effective documentation for AI agent work?

Effective documentation explains the 'why' behind decisions with specific context, not just what was done. Structure entries with decision rationales, discovered insights, and blockers using standardized formatting. Avoid anti-patterns like deferring documentation or assuming context is obvious to future reference.

How does proactive documentation prevent repeated work?

Structured `/docent:tell` entries create persistent memory across sessions, allowing seamless context switching and future reference. Documenting decisions, insights, and blockers immediately after discovery transforms ephemeral work into searchable knowledge that survives task completion and session boundaries.

Can I use this for software feature development workflows?

Yes. This guidance applies across software projects to document post-work summaries, decision rationales, and discovered insights. It ensures every key decision and completion during feature development automatically creates rich, persistent working memory for future reference and context switching.