Skip to content
cccskills
FreePublished on GitHub

hyalo-tidy

Audit or tidy a Hyalo knowledgebase for broken links, orphan documents, stale content, and inconsistent metadata.

The English summary is being prepared. Showing the original description.

Run score Not tested

See how to install

Files included (4)

  • SKILL.md1.8 KB
  • agents/openai.yaml253 B
  • references/jev.md9.0 KB
  • scripts/jev.mjs50.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

<!-- hyalo:managed -->

Knowledgebase maintenance

Resolve the installed hyalo executable and run hyalo config --format json. Use the configured vault and existing schemas. If the executable or configuration is missing, report what is needed before doing maintenance.

An audit or health question is read-only. A request to tidy or repair authorizes relevant changes, not deletion of notes based only on age or orphan status.

Only when the user explicitly selects Jev assistance, read references/jev.md and follow its scoped preparation and suggestion workflow before loading full documents. An API key or repository setting never enables Jev. Ordinary tidy needs no JavaScript runtime or network access; Jev failure leaves the usual local workflow available.

Orient with hyalo summary --format text, hyalo lint --format text, and hyalo find --broken-links --format text. Inspect individual files with hyalo read. Check schemas with hyalo types list before proposing metadata normalization. An orphan can be a legitimate entry point; stale status requires evidence from its content.

Prioritize concrete findings. When authorized to repair, preview applicable fixes (hyalo lint --fix --dry-run; consult hyalo links --help for link repairs). Use Hyalo for frontmatter and tasks, normal editing tools for prose, and preserve meaning. Do not apply uncertain fuzzy link replacements without inspecting the candidates.

Run lint on changed files and recheck the original findings. Report what changed, what remains unresolved, and any skipped or failed checks. Keep audit-only runs free of writes, including creating or dropping snapshot indexes.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Run a dogfooding session for hyalo — build from source, exercise the CLI against real knowledgebases (own KB, MDN, GitHub Docs, VS Code docs), find bugs, verify recent fixes, assess UX, measure performance, and write a structured report. Use this skill whenever the user says /dogfood, "dogfood", "run a dogfood session", "test hyalo against real data", or wants to exercise hyalo on real knowledgebases to find issues.

The English summary is being prepared. Showing the original description.

ractive/hyalo27Updated Oct 18, 2026

hyalo

Free

Search and edit structured markdown knowledgebases with the Hyalo CLI: frontmatter, tags, tasks, links, and document structure.

The English summary is being prepared. Showing the original description.

ractive/hyalo27Updated Oct 18, 2026

hyalo

Free

Use the hyalo CLI instead of read/edit/grep/write when working with markdown (.md) files that have YAML frontmatter. This skill MUST be consulted whenever pi is working with markdown documentation directories, knowledgebases, wikis, notes, Obsidian-compatible collections, Zettelkasten systems, iteration plans, or any collection of .md files with frontmatter. Trigger this skill when: searching or filtering markdown files by content, tags, or properties; reading or modifying YAML frontmatter; managing tags or metadata across documents; toggling task checkboxes in markdown; getting an overview of a documentation directory; querying document properties or status fields; bulk-updating metadata across many markdown files; or when you find yourself repeatedly using read/edit/grep/write on .md files. Even if the user does not mention "hyalo" by name, use this skill whenever the task involves structured markdown documents with frontmatter. For pi sessions, ALWAYS use `--format text` for compact, LLM-friendly output.

The English summary is being prepared. Showing the original description.

ractive/hyalo27Updated Oct 18, 2026

Maintain Keep a Changelog files with Hyalo's changelog profile and add/release commands.

The English summary is being prepared. Showing the original description.

ractive/hyalo27Updated Oct 18, 2026

Maintain Markdown Architecture Decision Records with Hyalo's MADR profile and table-of-contents commands.

The English summary is being prepared. Showing the original description.

ractive/hyalo27Updated Oct 18, 2026

Maintain Open Knowledge Format vaults with Hyalo's OKF index, log, and conformance commands.

The English summary is being prepared. Showing the original description.

ractive/hyalo27Updated Oct 18, 2026

See all skills by ractive

Report a problem with this skill