← Back to Skills Marketplace
joeyxin-del

Secretary Skill

by joeyxin-del · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ⚠ pending
70
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install secretaryskills
Description
Helps users clarify, break down, and schedule long-term goals into manageable tasks with automated reminders and progress tracking.
README (SKILL.md)

Secretary Skill

A specialized procedural tool that prevents long-term plans from failing by combating the three main killers of long-term goals: ambiguity (not knowing how to start), overwhelm (large goals feeling impossible), and oblivion (forgetting or losing motivation over time).

Core Workflow

[Vague/Profound Goal]
       │
       ▼
 1. De-ambiguation  ──► Asks targeted questions ──► Locks in the "Original Goal"
       │
       ▼
 2. Vertical Splitting ──► Breaks goal into Milestones ──► Generates Atomic Tasks
       │
       ▼
 3. Cron Automation   ──► Sets execution frequency ──► Outputs Cron configuration

Interaction Rules (Critical)

De-ambiguation Phase: One Question at a Time

NEVER ask multiple questions at once. The de-ambiguation phase must follow this protocol:

  1. The user states a vague vision.
  2. You ask ONE thoughtful question from the conversational bank.
  3. Wait for the user's full answer.
  4. Briefly acknowledge the answer (1 sentence max).
  5. Ask: "现在清晰了吗?" — if yes and core topics (meaning, scope, timeline) are covered, lock the goal and move on.
  6. If not clear yet, ask the next single question.
  7. Repeat until the user says it's clear.

Question style guidelines:

  • Each question must reference the user's own words where possible.
  • Questions should feel like a curious coach, not a form.
  • Topics to explore (in order): meaning → scope → measurement → timeline → stakeholders → risk
  • If the user volunteers enough context, skip the topic.
  • The goal is not to ask every question — it's to get the user to say "清楚了".

Other Phases

Command Description
/init_goal [text] Activates the de-ambiguation engine using the one-question-at-a-time protocol above.
/split --depth [1-3] Takes the locked goal and hierarchically breaks it down into high-level milestones down to 2-hour executable atomic tasks.
/schedule --freq [daily/weekly] Maps tasks onto a timeline and automatically formats a JSON payload ready to be injected into an automation engine.
/align Triggered when plans change, friction occurs, or tasks are missed. Recalibrates tactical steps without losing sight of the Original Goal.
/status --report Evaluates current progress and visually maps how much closer you are to the final goal.

Automation Interface (Cron Bridge)

{
  "skill_target": "Secretary Skill",
  "cron_expression": "0 9 * * 1-5",
  "action_type": "active_reminder",
  "payload": {
    "original_goal_snapshot": "[Locked Goal]",
    "current_task": "[Task X]",
    "trigger_prompt": "Re-anchor the user to the grand vision, verify if [Task X] is ready for today, and listen for a `/align` call if scheduling conflicts exist."
  }
}
Capability Tags
crypto
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install secretaryskills
  3. After installation, invoke the skill by name or use /secretaryskills
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Added automated test coverage with new test files for core engine and markdown storage. - Improved de-ambiguation phase documentation: strictly enforces "one question at a time" protocol in SKILL.md. - Enhanced clarity on question style, topic sequence, and interaction rules for plan initialization. - Internal changes in CLI and engine source files to support updated workflow and testing.
v1.0.1
- Added .pyc (compiled Python) files to the src/__pycache__ directory for initialization, CLI, engine, and markdown store modules. - No changes were made to the documentation or feature set.
v1.0.0
- Initial release of secretary-skill, a procedural tool for effective long-term planning and execution. - Introduces a three-stage pipeline: de-ambiguation, vertical splitting, and cron automation. - Provides CLI commands for setting and refining goals, breaking them into actionable tasks, scheduling, alignment, and status tracking. - Integrates with automation engines via a JSON-based Cron Bridge for reminders and progress monitoring.
Metadata
Slug secretaryskills
Version 1.0.2
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is Secretary Skill?

Helps users clarify, break down, and schedule long-term goals into manageable tasks with automated reminders and progress tracking. It is an AI Agent Skill for Claude Code / OpenClaw, with 70 downloads so far.

How do I install Secretary Skill?

Run "/install secretaryskills" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Secretary Skill free?

Yes, Secretary Skill is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Secretary Skill support?

Secretary Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Secretary Skill?

It is built and maintained by joeyxin-del (@joeyxin-del); the current version is v1.0.2.

💬 Comments