word-tracker

Count words across markdown files and generate a versioned CSV tracker.

1|1|Updated Oct 21, 2025
One-click install
npx skills add https://github.com/blossomz37/ffa-skills-project --skill word-tracker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: word-tracker
Source: https://github.com/blossomz37/ffa-skills-project/tree/main/skills/word-tracker
Command: npx skills add https://github.com/blossomz37/ffa-skills-project --skill word-tracker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Authors and editors waste time manually counting words, tracking revisions, and aggregating progress across many markdown files; this skill automates accurate word counts, date tracking, and progress reporting so you can focus on writing instead of bookkeeping.

Core Features & Use Cases

  • Count words across individual markdown files or entire directories with optional recursive scanning.
  • Maintain a version-friendly CSV tracker that records word counts, date created, and date updated for each file.
  • Advanced counting options include excluding YAML frontmatter, ignoring code blocks, handling hyphenated words, and calculating manuscript-style counts and reading time.
  • Built-in CLI and programmatic package API enable scheduled reports, pre-commit hooks, batch processing across projects, and progress-to-goal analytics for novel- or series-scale workflows.

Quick Start

Run the standalone tracker against your drafts folder to create or update a CSV progress tracker and generate a summary report.

Frequently Asked Questions about word-tracker

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

FAQPage Schema
How do I track word count across multiple markdown manuscript files?

To track word count across markdown manuscripts, you can recursively scan directories to aggregate per-file counts into a versioned CSV tracker. This automates per-file and project-level analytics by recording word counts alongside date-created and date-updated metadata.

Can I exclude frontmatter and code blocks when counting words in markdown?

Yes, you can exclude YAML frontmatter and ignore code blocks during word counting. The tracker provides configurable options for accurate manuscript-style counts, including handling hyphenated words and calculating reading time.

What is the best way to automate manuscript progress tracking for a novel?

Automating manuscript progress tracking is best done using a CLI to run batch processing across project directories, generating a CSV tracker for version control. You can schedule reports or use pre-commit hooks to maintain progress-to-goal analytics for novel-scale workflows.

Do I need external dependencies to count words and export a CSV tracker?

No external third-party dependencies are required to count words and export a CSV tracker. The Skill operates standalone using built-in CLI and programmatic APIs to perform directory scanning and generate version-friendly CSV files.

Does the markdown word tracker support programmatic APIs for batch processing?

Yes, the markdown word tracker supports programmatic package APIs for batch processing across projects. This enables scheduled reports and progress-to-goal analytics alongside its built-in CLI for direct manuscript directory scanning.

Why does my markdown word count include YAML metadata instead of just manuscript text?

Your markdown word count includes YAML metadata because frontmatter exclusion is a configurable option that must be explicitly enabled. By default, counting may include frontmatter, so you need to toggle the setting to ignore YAML metadata for accurate manuscript-style counts.