notebook-management-extraction

Extract and lint Mathematica notebook metadata for SourceVault queries.

3|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/transreal/claudecode --skill notebook-management-extraction
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notebook-management-extraction
Source: https://github.com/transreal/claudecode/tree/main/Claude%20Directives/skills/notebook-management-extraction
Command: npx skills add https://github.com/transreal/claudecode --skill notebook-management-extraction

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you manage Mathematica notebooks as first-class SourceVault sources by deterministically extracting header metadata and Todo status without relying on LLM guesswork.

Core Features & Use Cases

  • Deterministic notebook discovery: Converts natural-language notebook requests into structured SourceVault queries (e.g., OpenTodos, NextReview, Deadline, Title/Keywords, and Scope="Today") and enforces the correct formatting pipeline via SourceVaultFindNotebooks + SourceVaultFormatNotebookList.
  • Safe parsing and consistent interpretation: Extracts Header information via Import[path, "Initialization"] with whitelist validation and extracts TodoItem cells via NotebookImport with style-based cell retrieval (fallbacks included).
  • Consistency linting for operational reliability: Detects 7+ integrity issues (e.g., header status vs open Todo mismatch, malformed dates, Todo status heuristic-only cases) so review dashboards remain trustworthy.

Quick Start

Ask Claude to generate a deterministic notebook list query for today’s OpenTodos using SourceVaultFindNotebooks[..., "Format" -> True] and return the results wrapped in SourceVaultFormatNotebookList so the dashboard has the expected columns and actions.

Frequently Asked Questions about notebook-management-extraction

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

FAQPage Schema
How do I extract metadata from Mathematica notebooks deterministically?

Extract Mathematica notebook metadata deterministically using Wolfram-standard Import[path, "Initialization"] with whitelist validation and NotebookImport for TodoItem cells, avoiding LLM guesswork. This ensures reliable header information retrieval for operational workflows.

How do I lint Mathematica notebooks for Todo status and header mismatches?

Lint Mathematica notebooks for Todo status and header mismatches by detecting over seven integrity issues, including malformed dates and heuristic-only Todo states. Consistency linting ensures operational reliability so review dashboards remain trustworthy.

What is the best way to query open Todo notebooks by deadline or next review date?

Query open Todo notebooks by deadline or next review date by converting natural-language requests into structured SourceVaultFindNotebooks queries with parameters like OpenTodos, NextReview, and Deadline. Results are formatted via SourceVaultFormatNotebookList to ensure correct dashboard columns.

Can I filter Mathematica notebooks by title keywords with synonym expansion?

Filter Mathematica notebooks by title keywords with synonym expansion using structured SourceVault queries. The deterministic extraction applies whitelist validation to match keywords and titles accurately, avoiding incorrect lookups from LLM guesswork.

How do I list overdue notebooks using SourceVault queries?

List overdue notebooks using SourceVaultFindNotebooks with date scopes such as Overdue, Today, or ThisWeek. The Skill wraps results in SourceVaultFormatNotebookList to generate a formatted dashboard list with expected columns and actions.

Why do my Mathematica notebook queries return incorrect title lookups or custom grids?

Incorrect title lookups or custom grids occur when query formatting constraints are not enforced. Use SourceVaultFindNotebooks and SourceVaultFormatNotebookList to apply deterministic formatting pipelines, avoiding custom grids and incorrect Title lookups.