skills.rest
nimdvir
nimdvirCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

call-out

Create standardized HTML callout blocks in BITM330 chapter Markdown files.

1|Updated May 26, 2026
Search Tags:#markdown#html#accessibility#formatting#textbook#admonition#callout
One-click install
npx skills add https://github.com/nimdvir/dima-publishing --skill call-out-nimdvir
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: call-out
Source: https://github.com/nimdvir/dima-publishing/tree/main/.agents/skills/call-out
Command: npx skills add https://github.com/nimdvir/dima-publishing --skill call-out-nimdvir

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Chapters often contain inconsistent admonitions—emoji-only notes, blockquotes, GitHub alerts, or inline-styled divs—that render unpredictably and confuse readers. This Skill enforces one canonical HTML callout format with a fixed emoji legend, CSS classes, and density rules so every callout is consistent, accessible, and instructionally purposeful. ## Core Features & Use Cases - Canonical Callout Generation: Produces <div class="callout type"> blocks with the correct emoji, label, headline, and body for 16 callout types including Tip, Warning, Definition, and Business Insight. - Legacy Conversion: Converts emoji-only notes, blockquotes, GitHub alert syntax (> [!NOTE]), and inline-styled divs into class-based callouts. - Chapter Auditing: Checks callout density, placement, label consistency, and accessibility against a defined checklist. - Use Case: While editing a database textbook chapter, convert a blockquote warning about DROP TABLE into a canonical warning callout and audit the section for callout overuse. ## Quick Start Convert the blockquote warnings in chapter 3 of my BITM330 Markdown file into canonical HTML callouts and audit the chapter for callout overuse.

Frequently Asked Questions about call-out

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a callout or admonition in Markdown that converts to HTML?▼

Use a semantic HTML div with the base class callout plus a type class such as tip or warning. The first paragraph contains the emoji, label, and headline in bold, followed by a short body paragraph inside the same div.

How do I convert GitHub alert syntax like > [!NOTE] to HTML callouts?▼

Replace the alert blockquote with a div using the matching callout class, such as note or warning. Move the content into a bold headline line with the canonical emoji and label, plus a short body paragraph.

What callout type should I use for definitions versus vocabulary terms?▼

Use definition for general meanings, discipline-definition for field-specific meanings like SQL or MIS terms, term for vocabulary and nomenclature, and concept for abstract theories or mental models.

How many callouts should a chapter section contain?▼

Limit density to roughly one callout per 150 words of body text, no more than 3-5 per major H2 section, and about 8-12 per full chapter. Avoid back-to-back callouts unless each serves a clearly different purpose.

Where should callout CSS styles be defined?▼

Callout styles belong in the live book repository at _static/call-outs.css, loaded via the extra_css setting in _config.yml. Do not embed inline styles or CSS inside chapter Markdown files.

Related Skills

Explore More Education & Research Skills→
tylersahaguntylersahagun

prose-generation

Generate book prose with defined voice, tone, and chapter flow patterns.

Community
Intermediate
NoiseMeldOrgNoiseMeldOrg

extract-book

Extract PDF book content into chapterized Markdown with metadata.

Official
Advanced
Azeem-2Azeem-2
1

prose-generation

Standardize book prose with consistent perspective, tone, readability, and structural patterns.

Community
Basic
CloudyWingCloudyWing

check-markdown

Detects and corrects Markdown formatting and platform-specific admonitions in documentation files.

Community
Intermediate