secretary

Archives chat history into persistent topic markdown files with checkpoint tracking.

Updated Nov 21, 2025
One-click install
npx skills add https://github.com/alatyshau/duet --skill secretary-alatyshau
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: secretary
Source: https://github.com/alatyshau/duet/tree/main/packages/skills/modes/secretary
Command: npx skills add https://github.com/alatyshau/duet --skill secretary-alatyshau

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Long AI chat sessions accumulate valuable thoughts that get lost when the chat closes or context is compacted. This Skill transfers every idea from the conversation into durable markdown files in the project folder, so nothing is lost and context can be restored from disk. ## Core Features & Use Cases - Full Chat Archiving: Walks every message from the last checkpoint to the present and records each thought into topic_*.md files, appending rather than overwriting. - Checkpoint Tracking: Emits an @secretary_checkpoint(TIMESTAMP) marker into the chat so the next run knows exactly where to resume, even after context compaction. - Index Maintenance: Updates index.md with current topic summaries and can propose topic refactoring when the structure no longer fits. - Use Case: Before closing a long planning session, invoke /secretary to export all decisions and ideas into project files, then start a fresh chat and restore context from disk. ## Quick Start Type /secretary to archive all thoughts from the current chat into topic files in the project folder.

Frequently Asked Questions about secretary

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

FAQPage Schema
How do I archive an AI chat conversation to markdown files?

Invoke the /secretary command, which walks every message since the last checkpoint and writes each thought into topic_*.md files in the project folder. It appends to existing topics and creates new ones when needed, then updates index.md with current summaries.

What is the difference between /secretary and /compact?

/compact compresses context into a summary kept in AI memory, while /secretary exports content to persistent markdown files for the human. /secretary is append-only and manual, whereas /compact replaces history and can run automatically.

How does the secretary checkpoint survive context compaction?

The checkpoint is output to the chat as an H1 marker like @secretary_checkpoint(260112_210000M) rather than written to a file. Because it lives in the conversation, it survives compaction summaries and is visible to the AI on the next run.

When should I run chat archiving during a project?

Run it before executing a plan, after a long dialogue with many accumulated thoughts, or before closing a chat. These moments ensure accumulated context is safely on disk before it can be lost.

Can the secretary mode create new topic files?

Yes, it can create a new topic file when archiving completeness requires it, though this is an exception rather than the norm. New topics are usually created during regular dialogue mode.