⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

version unknown

obsidian-task-board-core

drvillo@drvillo⭐ 1 stars· last commit 7mo ago· 0 open issues

Manage a Markdown-native Obsidian task board through a deterministic CLI with linting, active-only inbox migration, archive/attic moves, agent-task reconciliation, and reminder maintenance. Use when Codex needs to create, update, validate, reconcile, or clean up an Obsidian task board stored in Markdown files.

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐ 1 on GitHubGitHub ↗

New / niche

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

Obsidian Task Board Core Skill

Portable OpenClaw skill for managing a Markdown-native Obsidian task board through a deterministic CLI.

This repo is the public skill bundle for obsidian-task-board-core. It focuses on:

  • linting and validating task-board structure
  • active-only inbox management
  • archive and attic moves
  • agent-task reconciliation
  • reminder maintenance

It is intentionally CLI-first and does not require Lobster.

Contents

  • SKILL.md: skill definition and usage guidance
  • scripts/task_board.py: canonical task-board CLI
  • references/configuration.md: env vars and path configuration
  • references/task-model.md: task schema and lifecycle rules
  • agents/openai.yaml: UI metadata

Configuration

Required:

  • TASK_BOARD_INBOX, or pass --file to the CLI

Optional:

  • TASK_BOARD_DETAILS_DIR
  • TASK_BOARD_ATTIC_FILE
  • TASK_BOARD_TASKS_DIR

If optional paths are omitted, the CLI derives them from the inbox path.

Example

export TASK_BOARD_INBOX="$HOME/Documents/Obsidian/MyVault/Tasks/Task Inbox.md"
python3 scripts/task_board.py lint
python3 scripts/task_board.py snapshot

Notes

  • Keep machine-specific paths, cron wiring, agent IDs, and Lobster workflows in a private local overlay.
  • The local/private overlay used in the original deployment is not part of this repo.

// HOW IT'S BUILT

// FILES

2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • SKILL.md2.8 KBupstream ↗
    ---
    name: obsidian-task-board-core
    description: Manage a Markdown-native Obsidian task board through a deterministic CLI with linting, active-only inbox migration, archive/attic moves, agent-task reconciliation, and reminder maintenance. Use when Codex needs to create, update, validate, reconcile, or clean up an Obsidian task board stored in Markdown files.
    metadata: {"openclaw":{"skillKey":"obsidian-task-board-core","requires":{"anyBins":["python3","python"],"env":["TASK_BOARD_INBOX"]}}}
    ---
    
    # Obsidian Task Board Core
    
    ## Overview
    
    Use this skill to manage an Obsidian task board as structured Markdown instead of freehand text edits. The core interface is `scripts/task_board.py`, which provides deterministic commands for linting, task creation and updates, archive/attic hygiene, agent-task reconciliation, and reminder resolution.
    
    ## Configuration
    
    - Required:
      - Set `TASK_BOARD_INBOX` to the path of `Task Inbox.md`, or pass `--file` explicitly on each command.
    - Optional:
      - `TASK_BOARD_DETAILS_DIR`
      - `TASK_BOARD_ATTIC_FILE`
      - `TASK_BOARD_TASKS_DIR`
    - If optional paths are omitted, the CLI derives them from the inbox path.
    
    Read `references/configuration.md` for the exact env vars, defaults, and example commands.
    
    ## Core workflow
    
    1. Run `python3 {baseDir}/scripts/task_board.py lint` before and after non-trivial board mutations.
    2. Use the CLI for all task creation, updates, closure, archive, attic moves, reconciliation, and reminder resolution.
    3. Treat the inbox as active-only:
       - keep `next`, `waiting`, and agent tasks in `queued|running|blocked|review_needed`
       - move `done` tasks to monthly archives
       - move stale discarded items to the attic
    4. For blocked or `review_needed` agent tasks, keep triage metadata in the detail note:
       - `owner`
       - `next_action`
       - `blocked_on`
       - `decision_by`
    
    ## Common commands
    
    - Snapshot:
    ```bash
    python3 {baseDir}/scripts/task_board.py snapshot
    ```
    - Create a task:
    ```bash
    python3 {baseDir}/scripts/task_board.py create --stdin-json
    ```
    - Reconcile an agent task:
    ```bash
    python3 {baseDir}/scripts/task_board.py reconcile-agent-task --stdin-json
    ```
    - Archive completed tasks:
    ```bash
    python3 {baseDir}/scripts/task_board.py archive-done --older-than-days 1
    ```
    - Resolve an overdue reminder:
    ```bash
    python3 {baseDir}/scripts/task_board.py resolve-reminder --id <task-id> --remind-on YYYY-MM-DD
    ```
    
    ## References
    
    - `references/configuration.md` for env vars, path defaults, and invocation patterns
    - `references/task-model.md` for the task schema and lifecycle rules
    
    ## Notes
    
    - This skill is intentionally CLI-first and does not require Lobster.
    - If Lobster is installed, wrap these commands in local workflows outside the public skill.
    - Keep machine-specific paths, agent IDs, cron wiring, and user-specific helper scripts in a private local overlay rather than editing this skill.
    
  • README.mdupstream ↗

    Contents are not inlined in the catalog. Open the upstream file.

Plain-text copy, no login: /skill-bundles/drvillo-obsidian-task-board-core-skill.md

// REPO STATS

1 stars
0 open issues
Last commit: 7mo ago