habits

Original：🇨🇳 Chinese

Translated

2 scripts

Manage daily check-in records stored in local SQLite, supporting functions including adding check-ins, viewing records, statistical analysis, querying consecutive check-in days, deleting and modifying records. This skill should be actively used when users mention check-in, sign-in, recording daily habits such as exercise, reading, learning, fitness, meditation, running, cycling, etc., or want to check how many days they have stuck to a certain habit, how much time they spent exercising this week, what they checked in today. Even if the user does not explicitly say "check-in", it is applicable as long as it involves daily habit tracking and activity recording. It also works for English scenarios, such as check in, log my workout, track my reading, how many days in a row, streak, habits.

2installs

Sourcezsspub/skills

Added on2026-04-03

NPX Install

npx skill4agent add zsspub/skills habits

SKILL.md Content (Chinese)

View Translation Comparison →

Daily Check-in Skill

Record and manage daily check-in data based on local SQLite database. The data file is automatically located by the script through

import.meta.dirname

, stored in the

.data/zsspub/habits/

directory at the same level as the skill directory, no manual path configuration is required. Time is stored in the database in UTC, and will be automatically converted according to the user-configured time zone when displayed.

Environment Requirements

Node.js >= 22.5.0 (uses built-in
```
node:sqlite
```
)

Execution Method

All commands are run directly through

node

:

bash

node <directory where this SKILL.md is located>/scripts/habits.mjs <command> [options]

In the following content,

habits

refers to

node <skill directory>/scripts/habits.mjs

, please replace it with the actual path.

First Time Use: Configure Time Zone

The script stores time in UTC in the database, and converts it according to the user-configured time zone when displaying. When using for the first time, please first determine the user's time zone and run the

config --timezone

command:

If the user mentions a city (e.g. "I am in Shanghai"), infer it as
```
Asia/Shanghai
```
If it cannot be determined, ask the user for their city or time zone, then run:

bash

habits config --timezone=Asia/Shanghai

Usage Process

Step 1: Understand user intent and map to commands

The core of check-in is to extract structured information from the user's natural language:

User's words (example)	Extracted information	Command to execute
"Check in cycling for 30 minutes"	Topic=cycling, Tag=sports, Duration=30	`add` (also use `--raw` to store the original words)
"I read a chapter of Principles today"	Topic=reading, Tag=learning, Note=one chapter of Principles	`add`
"Just finished running 5 kilometers in 40 minutes"	Topic=running, Tag=sports, Duration=40, Note=5km	`add`
"Meditation check-in"	Topic=meditation, Tag=health	`add` (no duration)
"Check in at the Forbidden City"	Topic=travel, Tag=life, Note=Forbidden City	`add`
"Show my check-in records this month"	—	`list --period=month`
"How much time did I spend exercising this week?"	—	`stats --period=week --tag=sports`
"How many consecutive days have I checked in for cycling?"	—	`streak --topic=cycling`
"Change the 3rd check-in to 45 minutes"	—	`update 3 --duration=45`
"Delete that running record"	—	First run `list` to find the id, then run `delete <id>`
"Export check-in records" / "Backup check-in data"	—	`export`
"Import check-in records" / "Restore from file"	—	`import --file=<path>`

Original text saving: Every time you run

add

to record a check-in, store the original text of the user's words as-is through the

--raw

parameter for future review.

Note extraction rules:

--note

is used to save key information that cannot be classified into other fields. For example:

Location information: city, scenic spot, restaurant name ("Check in at the Forbidden City" → Note=Forbidden City)
Specific content: book name, course name, food name ("Read Chapter 3 of Principles" → Note=Chapter 3 of Principles)
Quantitative indicators: distance, number of sets, pages and other values other than duration ("Ran 5 kilometers" → Note=5km)

Automatic tag inference rules:

Infer tags automatically based on the topic, users can override with

--tags

:

Topic keywords	Inferred tag
Cycling, running, swimming, fitness, yoga, stretching, brisk walking, rope skipping, ball games, mountain climbing, skiing, skating	Sports
Reading, book reading, listening to audiobooks	Learning
Meditation, early bedtime, early rising, drinking water, skincare	Health
Memorizing words, doing exercises, practicing piano, painting, writing, calligraphy practice, learning English	Learning
Cooking, housework, organizing, food, home practice	Life
Travel, visiting, sightseeing, scenic spot check-in	Life
Watching movies, chasing dramas, listening to music, playing games	Entertainment

If the topic is not in the above list, please infer reasonably according to the semantics. Check-in records should always have tags to facilitate subsequent statistics and filtering.

Duration inference rules:

"X minutes" →
```
--duration=X
```
"X hours" →
```
--duration=X*60
```
"X hours Y minutes" →
```
--duration=X*60+Y
```
"Half an hour" →
```
--duration=30
```
"X and a half hours" →
```
--duration=X*60+30
```
"One and a half hours" →
```
--duration=90
```
"A quarter of an hour" / "15 minutes" →
```
--duration=15
```
Do not pass
```
--duration
```
if no duration is mentioned

Step 2: Execute the command and present the result

Display the command output directly to the user. After a successful check-in, you can give a short encouragement.

Command Description

Add check-in

habits add "topic" --raw="user's original words" [--tags=tag1,tag2] [--duration=minutes] [--note="note"] [--at="YYYY-MM-DD HH:mm:ss"]

```
--raw
```
: Required, the original words of the user, stored as-is
```
--tags
```
: Comma-separated list of tags, e.g.
```
运动,户外
```
```
--duration
```
: Duration (minutes), positive integer
```
--note
```
: Note text
```
--at
```
: Check-in time (user's local time zone), default is current time. Used for retroactive check-in scenarios

View check-in records

habits list [--topic=topic] [--tag=tag] [--date=YYYY-MM-DD] [--period=today|week|month|year] [--from="YYYY-MM-DD HH:mm:ss"] [--to="YYYY-MM-DD HH:mm:ss"] [--search=keyword] [--limit=count]

```
--period
```
: Quick time range (today/week/month/year)
```
--date
```
: View all check-ins on a certain day
```
--from
```
/
```
--to
```
: Time range filtering
```
--search
```
: Fuzzy search by topic and note
```
--limit
```
: Limit the number of returned records
Default sorted in reverse chronological order

Modify check-in

habits update <id> [--topic=...] [--tags=...] [--duration=...] [--note=...] [--at="YYYY-MM-DD HH:mm:ss"]

Clear duration:
```
--duration=null
```

Alias:

edit

Delete check-in

habits delete <id>

Aliases:

del

,

rm

Statistical analysis

habits stats [--topic=topic] [--tag=tag] [--period=today|week|month|year] [--from="YYYY-MM-DD HH:mm:ss"] [--to="YYYY-MM-DD HH:mm:ss"]

```
--period
```
: Quick time range (today/week/month/year)
Output: total check-in times, total duration, statistics by topic, statistics by tag

Consecutive check-in query

habits streak [--topic=topic] [--tag=tag]

Output: current consecutive days, longest consecutive days, total check-in days

View/update configuration

habits config [--timezone=<IANA time zone>]

Export check-in records

habits export [--file=<path>] [--topic=topic] [--tag=tag]

Export to CSV format
```
--file
```
: Specify the output file path, if not specified, it will be automatically generated to the data directory
```
--topic
```
/
```
--tag
```
: Optional filtering conditions

Import check-in records

habits import --file=<path>

Import from CSV file, CSV must contain
```
topic
```
column
Data format will be verified before import, import will be canceled if verification fails

Examples

bash

# Check in cycling for 30 minutes
habits add "骑行" --tags=运动 --duration=30 --raw="打卡骑行 30 分钟"

# Check in reading, with note
habits add "阅读" --tags=学习 --note="《原则》第三章"

# Retroactive check-in (yesterday's run)
habits add "跑步" --tags=运动 --duration=40 --note="5公里" --at="2026-04-01 19:30:00"

# View today's check-ins
habits list --date=2026-04-02

# View all cycling records
habits list --topic=骑行

# Weekly exercise statistics
habits stats --period=week --tag=运动

# View consecutive cycling check-in days
habits streak --topic=骑行

# Modify the duration of the 2nd check-in
habits update 2 --duration=45

# Delete the 5th check-in
habits delete 5

habits

NPX Install

Tags

SKILL.md Content (Chinese)

Daily Check-in Skill

Environment Requirements

Execution Method

First Time Use: Configure Time Zone

Usage Process

Step 1: Understand user intent and map to commands

Step 2: Execute the command and present the result

Command Description

Add check-in

View check-in records

Modify check-in

Delete check-in

Statistical analysis

Consecutive check-in query

View/update configuration

Export check-in records

Import check-in records

Examples