SuperAPI AI Directory

skill-logger

Office & productivity

View repository

Updated 10-16 08:10

About this skill

Skill Usage Logging

After using a Skill each time, call this Skill to record a usage log. The log is appended to 06 计划/skill_usage_log.jsonl。

Log file location

$OBSIDIAN_VAULT/06 计划/skill_usage_log.jsonl

OBSIDIAN_VAULT The environment variable must be configured in .env (see below).

How to use

Method 1: Manually trigger after using a Skill

记录这次使用:x-post,场景是把播客笔记改成即刻动态,满意度 4 分,结尾不够有力手动改了

Method 2: Let the AI guide you through filling it in

Just say "record it", and the AI will ask in turn:

  1. Which Skill was used?
  2. What was the usage scenario?
  3. Satisfaction (1-5 points)?
  4. Notes (optional)?

Workflow

Step 1: Collect information

If the user has not provided complete information, ask item by item:

  • skill: Skill name (e.g. x-post)
  • scene: What was it used for this time (one-sentence description)
  • satisfaction: Satisfaction 1-5 points (1=very poor, 3=average, 5=perfect)
  • note: Notes, such as what was unsatisfactory or what was manually changed (can be empty)

Step 2: Run the append script

python3 scripts/log_skill_usage.py \
  --skill "x-post" \
  --scene "把播客笔记改成即刻动态" \
  --satisfaction 4 \
  --note "结尾不够有力,手动改了"

Step 3: Confirm the write

After the script outputs that the append succeeded, confirm with the user:

✅ 已记录:x-post(满意度 4/5)
   场景:把播客笔记改成即刻动态
   备注:结尾不够有力,手动改了

Log format

Each record is one line of JSON:

{"date": "2026-03-24", "weekday": "周二", "week": "W13", "skill": "x-post", "scene": "把播客笔记改成即刻动态", "satisfaction": 4, "note": "结尾不够有力,手动改了"}

Environment variable configuration

Configure in ~/.env or in the .env file in the project root directory:

# Skill 日志文件所在的 Obsidian vault 路径
OBSIDIAN_VAULT=/Users/ugreen/Documents/obsidian

The script reads it through os.environ['OBSIDIAN_VAULT'] , do not hardcode the path into the script.