Can I use this for standard Markdown files?

While it can read any Markdown file, it is optimized for a specific schema involving YAML frontmatter and specific header structures (### English, ### 中文, etc.).

How does this differ from the card-structure-handler?

The card-structure-handler (Agent) is responsible for the batch creation of cards, while this Skill is designed for interactive human-led validation and quality spot-checks.

Does this skill automatically fix formatting errors?

No, this skill is designed to read and analyze only. It provides a detailed diagnostic report with repair suggestions so you can manually edit files or run repair scripts safely.

What specific Japanese fields does it validate?

It checks for JLPT levels (N5-N1), specific card_id formats, and ensures that Japanese, Chinese, and English explanations are all present.

Japanese Card Structure Validator

Name: Japanese Card Structure Validator
Author: tarrragon

bytarrragon

0•

Learning & Documentation

Validates the structural integrity and formatting of Japanese language learning cards to ensure consistent data quality.

The card-structure-validator is a specialized tool designed to maintain high standards for Zettelkasten-style Japanese learning materials. It automatically analyzes Markdown files to verify YAML frontmatter metadata, checks for required content sections like definitions and example sentences, and ensures cross-linking follows the correct pathing conventions. This skill is essential for educators and language learners building large-scale digital flashcard libraries who need to diagnose formatting errors or missing information quickly through detailed diagnostic reports and actionable repair suggestions.

Key Features

01Actionable Fix Suggestions: Provides specific instructions on how to remedy identified structural issues.

02Markdown Link Verification: Ensures relative paths and link formats follow project standards.

03Content Completeness Audit: Verifies the presence of Japanese, Chinese, and English explanation blocks.

04Detailed Diagnostic Reports: Generates clear reports with specific pass, warning, and error statuses.

050 GitHub stars

06YAML Frontmatter Validation: Checks card_id, title, category, and JLPT levels for correct formatting.

Use Cases

01Troubleshooting rendering issues in Zettelkasten systems caused by malformed metadata.

02Auditing existing card libraries for missing English translations or incorrect JLPT level tags.

03Verifying newly created Japanese verb or noun cards before committing them to a repository.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tarrragon/japanese_learning_blog card-structure-validator

For use in Claude.ai and ChatGPT

Download Skill