Agent skill · Databases

time-ledger

Natural-language time tracking: parse what the user says they did into Activity/Minutes/Date rows in their own Notion database — asking instead of guessing when unsure.

Nick44,086★ · +407/wk · 1 repos on radarProfile →
claude-codecodexcursorMIT
Install
npx skills add sickn33/agentic-awesome-skills --skill time-ledger --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 1
SKILL.md size: 7 KB
Bundled scripts: none
Declared author: cruisekkk
Path: skills/time-ledger/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 44,414 · +328 this week
Language: Python
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# Time Ledger ## Overview Conversational time tracking. The user reports time in plain language — *"read papers 2h, gym 1h, did a leetcode"* — and the agent parses it into structured rows (activity, minutes, date, an optional compounding tag) and writes them to the user's own Notion database through the official Notion connector. The core design is an honesty contract: **anything uncertain becomes a `To-confirm` row and gets batch-asked — never fabricated.** A log that quietly invents durations is worse than no log. ## When to Use This Skill - Use when the user reports time spent ("read papers for two hours", "hit the gym for an hour", "coded all morning") - Use when the user says "log it", "log my time", "time ledger", or "tidy up my time ledger" - Use when the user asks where their time went or for a time review ## How It Works ### Step 1: Find the database (zero-config) On the first write of a session, use Notion `search` to find the **database** (type `database`, not a page) whose title contains **"time-ledger"**. Read its `data_source_id` (the `collection://...` UUID) and use it as the parent for `create-pages` / `query` for the rest of the session. If more than one matches, a

What's inside
Steps it walks through
  1. Overview
  2. When to Use This Skill
  3. How It Works
  4. Step 1: Find the database (zero-config)
  5. Step 2: Direct report mode
  6. Step 3: Batch reconcile mode
  7. Examples
  8. Example 1: Direct report
  9. Example 2: Batch reconcile
  10. Best Practices
  11. Limitations
  12. Security & Safety Notes
  13. Common Pitfalls
  14. Related Skills
More from agentic-awesome-skills
All skills →
About this skill
What does the time-ledger skill do?

Natural-language time tracking: parse what the user says they did into Activity/Minutes/Date rows in their own Notion database — asking instead of guessing when unsure.

How do I install it?

Run `npx skills add sickn33/agentic-awesome-skills --skill time-ledger --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From sickn33/agentic-awesome-skills, a repository with 44,414 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going