AGENT SKILL

list-cards

Lists all flashcards in an EstudeMe vault. Use when the user asks 'list my cards', 'what flashcards do I have', 'show me my cards', or wants a card inventory. Don't use to export cards to an external format — use export-cards.

License 许可
MIT
所属仓库
josenaldo/estudeme
最近更新
2026-05-25
Stars
★ 0
Forks
0

01 前言 Front Matter

name
list-cards
license
MIT
description
Lists all flashcards in an EstudeMe vault. Use when the user asks 'list my cards', 'what flashcards do I have', 'show me my cards', or wants a card inventory. Don't use to export cards to an external format — use export-cards.
compatibility
claude-code, gemini-cli, copilot, codex

03 SKILL.md 正文

Skill: List Cards

Instructions

Step 1: Confirm vault path

  • [ ] Confirm or ask for the vault path. Do not assume.

Step 2: Run the CLI

  • [ ] Execute: estudeme cards list <vault-path>
  • [ ] Capture stdout and exit code.

Step 3: Report

  • [ ] On success: present the card list. If the count is large (> 30), summarize by trail or card-type rather than listing every card.
  • [ ] On failure: surface the error message.

Critical

  • Read-only skill. Never modify cards or the vault.

Examples

Example 1: Direct listing

User says: "List the cards in ~/study/my-vault."

Actions:

  • Run estudeme cards list ~/study/my-vault
  • Present the cards grouped by trail (if multiple trails exist)

Result: User sees the card inventory.

Troubleshooting

Error: Cannot find vault directory

  • Cause: wrong path.
  • Solution: confirm with the user.

No cards listed but the user expected some

  • Cause: notes exist but no type: card documents.
  • Solution: suggest creating cards in the vault or running estudeme validate to verify card frontmatter.

Performance Notes

  • For very large vaults (> 100 cards), prefer summarizing over listing each.

04 同仓库更多 Skills

josenaldo
josenaldo/estudeme

list-trails

A test skill that should be ignored by the vault parser.

★ 0
josenaldo
josenaldo/estudeme

validate-vault

Validates an EstudeMe vault: checks frontmatter against the schema for each document type and reports broken wikilinks. Use when the user asks 'validate my vault', 'check my vault', 'any broken links', 'is my vault healthy'. Don't use to inspect a specific trail's progress — use inspect-trail.

★ 0
josenaldo
josenaldo/estudeme

review-vault-state

Gives a complete state overview of an EstudeMe vault by orchestrating validation, trail listing, and metrics into a single coherent report. Use when the user asks 'how is my vault', 'give me an overview', 'state of my study system', 'review my vault'. Don't use for a single trail — use inspect-trail.

Skill与智能体开发
★ 0
josenaldo
josenaldo/estudeme

report-metrics

Reports vault-wide metrics in an EstudeMe vault: trail count, module count, notes per trail, cards per trail, overall structure summary. Use when the user asks 'show vault metrics', 'how is my progress overall', 'give me numbers on my vault'. Don't use to inspect a single trail — use inspect-trail.

行政与办公人员
★ 0
josenaldo
josenaldo/estudeme

list-trails

Lists all trails (learning tracks) in an EstudeMe vault. Use when the user asks 'what trails do I have', 'list my trails', 'show me my trails', or wants an overview of their learning tracks. Don't use for progress detail on a specific trail — use inspect-trail.

★ 0
josenaldo
josenaldo/estudeme

inspect-trail

Shows detailed progress and status for a specific trail in an EstudeMe vault: modules covered, notes per module, completion percentage. Use when the user asks 'how is my trail X', 'status of trail X', 'progress on the Java trail'. Don't use to list multiple trails — use list-trails.

★ 0