name: gravitino-docs-refine
description: Use when refining Gravitino Markdown docs to match STYLE.md and pass docs audit scripts
allowed-tools: Bash
Gravitino Docs Style Refinement
Overview
Refine Markdown files under docs/ with focused, reviewable edits that follow STYLE.md.
Always validate with the audit scripts under .claude/skills/gravitino-docs-refine/scripts/ before finishing.
1---2name: gravitino3description: Licensed to the Apache Software Foundation (ASF) under one or more Use when this capability is needed.4---5<!--6 Licensed to the Apache Software Foundation (ASF) under one or more7 contributor license agreements. See the NOTICE file distributed with8 this work for additional information regarding copyright ownership.9 The ASF licenses this file to You under the Apache License, Version 2.010 (the "License"); you may not use this file except in compliance with11 the License. You may obtain a copy of the License at1213 http://www.apache.org/licenses/LICENSE-2.01415 Unless required by applicable law or agreed to in writing, software16 distributed under the License is distributed on an "AS IS" BASIS,17 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.18 See the License for the specific language governing permissions and19 limitations under the License.20-->2122---23name: gravitino-docs-refine24description: Use when refining Gravitino Markdown docs to match STYLE.md and pass docs audit scripts25allowed-tools: Bash26---2728# Gravitino Docs Style Refinement2930## Overview3132Refine Markdown files under `docs/` with focused, reviewable edits that follow `STYLE.md`.33Always validate with the audit scripts under `.claude/skills/gravitino-docs-refine/scripts/` before finishing.3435## Refinement Workflow36371. Read `STYLE.md` and the target file end to end.382. Apply focused style and structure edits only.393. Run the audit scripts in the required order.404. Fix issues by file and line number.415. Re-run the full script set until all checks pass.4243## Audit Scripts (Required)4445Run from the repository root.4647| Script | What it checks | When to run |48|---|---|---|49| `.claude/skills/gravitino-docs-refine/scripts/title_h2_audit.py` | First body H2 should not duplicate frontmatter `title` | After title or opening-section edits |50| `.claude/skills/gravitino-docs-refine/scripts/intro_audit.py` | Body content should not appear before the first H2 | After restructuring page openings |51| `.claude/skills/gravitino-docs-refine/scripts/heading_audit.py` | Heading hierarchy: first heading is H2 and no level jumps (`H2 -> H4`) | After heading edits |52| `.claude/skills/gravitino-docs-refine/scripts/heading_spacing_audit.py` | One blank line before and after each `H2`-`H6` heading | After formatting sweeps |53| `.claude/skills/gravitino-docs-refine/scripts/check_links.py` | Internal Markdown links and anchors under `docs/` | Final quality gate before PR |5455## Script Usage5657```bash58python3 .claude/skills/gravitino-docs-refine/scripts/title_h2_audit.py59python3 .claude/skills/gravitino-docs-refine/scripts/intro_audit.py60python3 .claude/skills/gravitino-docs-refine/scripts/heading_audit.py61python3 .claude/skills/gravitino-docs-refine/scripts/heading_spacing_audit.py62python3 .claude/skills/gravitino-docs-refine/scripts/check_links.py docs/63```6465Run as a single gate when finishing:6667```bash68python3 .claude/skills/gravitino-docs-refine/scripts/title_h2_audit.py \69 && python3 .claude/skills/gravitino-docs-refine/scripts/intro_audit.py \70 && python3 .claude/skills/gravitino-docs-refine/scripts/heading_audit.py \71 && python3 .claude/skills/gravitino-docs-refine/scripts/heading_spacing_audit.py \72 && python3 .claude/skills/gravitino-docs-refine/scripts/check_links.py docs/73```7475## Completion Criteria7677- Target docs comply with `STYLE.md`.78- All five scripts exit with code `0`.79- No unrelated files are changed.8081---82> Source: [apache/gravitino](https://github.com/apache/gravitino) — distributed by [TomeVault](https://tomevault.io).83<!-- tomevault:4.0:skill_md:2026-06-27 -->
Run npx skillmds@latest add tomevault-io/gravitino in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Licensed to the Apache Software Foundation (ASF) under one or more Use when this capability is needed. It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.