Installs npm packages (remark, unified) and runs scripts that read your Markdown files and write composed/transformed output to disk, overwriting files at the target path; review before running on an existing knowledge base.
Privacy notes
Inputs can include source files, prompts, logs, account metadata, repository details, and operational context that may be sent to the configured AI model., Redact secrets, customer data, private URLs, credentials, and proprietary implementation details before sharing prompts, reports, or generated artifacts.
Current risk score 0/100. Use staged verification before broader rollout.
Risk 0
Pre-adoption checks
Validate source and review signals before any execution.
Confirm source provenanceRequired
Source URL/provenance metadata is present.
Done
Confirm metadata review state
Listing has review metadata.
Done
Verify install payload
Install/config payload exists and can be inspected.
Done
Security checks
Confirm safety, privacy, and package integrity signals.
Review safety notesRequired
Safety notes are present.
Done
Review privacy notesRequired
Privacy notes are present.
Done
Verify package integrity metadata
Package verification/checksum metadata is available.
Done
Rollout
Adopt in controlled steps based on the selected plan.
Run in isolated sandbox firstRequired
Use a constrained sandbox and observe behavior across multiple tasks.
Pending
Roll out graduallyRequired
Roll out to a small cohort before wider usage.
Pending
Set monitoring and fallback
Define rollback path and monitor errors after adoption.
Pending
Evidence readiness
Evidence readiness matrix · balanced
Required evidence gates are covered (6/6 signals complete).
Risk 0
Source provenance
Present
Source repository/provenance is listed.
Required in this preset
Metadata review
Present
Review metadata is present.
Required in this preset
Safety notes
Present
Safety notes are present.
Required in this preset
Privacy notes
Present
Privacy notes are present.
Optional in this preset
Package integrity
Present
Package integrity metadata is present.
Optional in this preset
Install payload
Present
Install payload is available.
Required in this preset
Required evidence gates are covered for this preset.
Decision timeline
Decision timeline · balanced
6/6 steps complete with no blocking gaps for this preset.
Risk 0
triage
Confirm source provenanceRequired
Source/provenance metadata is available.
Done
triage
Check metadata review statusRequired
Review metadata is available.
Done
verify
Review safety notesRequired
Safety notes are available.
Done
verify
Review privacy notes
Privacy notes are available.
Done
verify
Validate package integrity metadata
Package integrity metadata is available.
Done
rollout
Verify install payload and commandsRequired
Install payload is available.
Done
No required blockers for this timeline preset.
Prerequisite readiness
Prerequisite readiness
6 prerequisites to line up before setup.
0/6 ready
Install & runtime1Network & hosting2General3
Safety & privacy surface
Safety & privacy surface
1 safety and 2 privacy notes across 3 risk areas. Review closely: credentials & tokens, third-party handling.
3 areas
SafetyLocal filesInstalls npm packages (remark, unified) and runs scripts that read your Markdown files and write composed/transformed output to disk, overwriting files at the target path; review before running on an existing knowledge base.
PrivacyThird-party handlingInputs can include source files, prompts, logs, account metadata, repository details, and operational context that may be sent to the configured AI model.
PrivacyCredentials & tokensRedact secrets, customer data, private URLs, credentials, and proprietary implementation details before sharing prompts, reports, or generated artifacts.
Safety notes
Installs npm packages (remark, unified) and runs scripts that read your Markdown files and write composed/transformed output to disk, overwriting files at the target path; review before running on an existing knowledge base.
Privacy notes
Inputs can include source files, prompts, logs, account metadata, repository details, and operational context that may be sent to the configured AI model.
Redact secrets, customer data, private URLs, credentials, and proprietary implementation details before sharing prompts, reports, or generated artifacts.
Prerequisites
Node.js 18+
remark / unified
Playwright (optional for PDF export)
pandoc (optional for DOCX/EPUB export)
File system read/write access for Markdown source files, generated HTML/PDF/DOCX/EPUB outputs, and image assets referenced in Markdown
Markdown syntax knowledge or reference documentation for creating valid Markdown files (CommonMark or GitHub Flavored Markdown specification)
.gemini/skills/<skill-name>/SKILL.md or .agents/skills/<skill-name>/SKILL.md
cursor
Adapter
.cursor/rules/<skill-name>.mdc
cli
Manual
AGENTS.md or tool-specific context file
Full copyable content
import { readFileSync, readdirSync } from 'node:fs';
import { join } from 'node:path';
import { unified } from 'unified';
import remarkParse from 'remark-parse';
import remarkStringify from 'remark-stringify';
import remarkToc from 'remark-toc';
import remarkSlug from 'remark-slug';
const dir = './notes';
const files = readdirSync(dir).filter(f => f.endsWith('.md'));
for (const file of files) {
const input = readFileSync(join(dir, file), 'utf8');
const tree = unified()
.use(remarkParse)
.use(remarkSlug)
.use(remarkToc, { tight: true })
.use(remarkStringify)
.processSync(input);
console.log(String(tree));
}
About this resource
What This Skill Enables
Claude can organize, process, and transform Markdown documentation into cohesive knowledge bases. Generate table of contents, fix broken links, convert formats, create static sites, and export to PDF or HTML.
Compatibility
Native
Claude Code / Claude: native skill usage via SKILL.md.
Codex/OpenAI workflows: compatible with Agent Skills-style SKILL.md content as reusable workflow instructions.
Manual Adaptation
Gemini CLI: native skill usage via .gemini/skills/<skill-name>/SKILL.md or .agents/skills/<skill-name>/SKILL.md where supported.
Cursor: use the generated .cursor/rules/*.mdc adapter for project rules.
OpenClaw and similar agents: use the same skill content as a reusable prompt/workflow file when native skill import is unavailable.
Prerequisites
Required:
Claude Pro subscription
Code Interpreter feature enabled
Markdown files uploaded (can be multiple files/folders)
Prompt: "Generate a table of contents from all these Markdown files. Include links to each section."
Claude will:
Parse all Markdown files
Extract headings
Create hierarchical TOC
Add anchor links
Save as README.md or TOC.md
Fix Broken Links
Prompt: "Check all internal links in these Markdown files and fix any broken ones. Report what was fixed."
Claude will:
Parse all Markdown files
Extract all links
Validate targets exist
Fix broken links
Report changes made
Convert Format
Prompt: "Convert all these Markdown docs to a single PDF with:
Table of contents
Page numbers
Consistent heading styles
Code syntax highlighting"
Claude will:
Merge Markdown files
Generate TOC
Apply styling
Convert to PDF
Export final document
Create Static Site
Prompt: "Generate a static HTML site from these docs:
Homepage with navigation
Responsive design
Search functionality
Dark mode toggle"
Claude will:
Process Markdown to HTML
Generate navigation
Apply responsive CSS
Add JavaScript features
Create static site files
Common Workflows
Documentation Site Generation
"Create documentation site:
1. Parse all .md files in docs/
2. Generate sidebar navigation
3. Create search index
4. Add syntax highlighting for code blocks
5. Export as static HTML site
Use clean, professional styling."
Knowledge Base Consolidation
"Consolidate scattered notes:
1. Combine all Markdown files into sections
2. Generate master TOC
3. Normalize heading levels (start all at H1)
4. Fix relative links between files
5. Create single comprehensive document
Export as both Markdown and PDF."
README Generation
"Generate professional README.md:
1. Extract project info from package.json
2. Add badges (build status, version, license)
3. Create sections: About, Installation, Usage, Contributing
4. Add table of contents with anchor links
5. Include code examples from docs/"
Multi-Format Export
"Export documentation in multiple formats:
1. HTML (with navigation and search)
2. PDF (with TOC and page numbers)
3. EPUB (for e-readers)
4. DOCX (for Word)
Maintain consistent styling across all formats."
Features & Capabilities
Markdown Processing
Parse frontmatter (YAML, TOML)
Extract and process links
Handle images and media
Process code blocks
Parse tables
Support GFM (GitHub Flavored Markdown)
Link Management
Validate internal links
Fix broken references
Convert relative to absolute
Update moved files
Generate anchor links
Content Organization
Auto-generate TOC at any level
Sort files by frontmatter or name
Create hierarchical structure
Merge multiple files
Split large files
Format Conversion
Markdown → HTML
Markdown → PDF
Markdown → DOCX
Markdown → EPUB
HTML → Markdown
Tips for Best Results
File Organization: Upload files with clear directory structure
Frontmatter: Use YAML frontmatter for metadata (title, date, tags)
Link Style: Be consistent with link styles (relative vs absolute)
Heading Hierarchy: Start with H1, don't skip levels
File Naming: Use kebab-case or snake_case consistently
Image Paths: Keep images in dedicated folder (./images/ or ./assets/)
Code Blocks: Always specify language for syntax highlighting
Advanced Operations
Custom Transformations
Replace text patterns across all files
Add custom frontmatter
Insert headers/footers
Inject custom CSS/JS
Apply templates
Multi-Language Support
Organize by language (en/, es/, etc.)
Generate language switcher
Maintain translation links
Version Control
Track changes between versions
Generate changelogs
Compare documentation versions
Troubleshooting
Issue: Broken links after reorganizing files
Solution: "Scan all links and update paths based on new file structure"
Issue: TOC not rendering correctly
Solution: Ensure consistent heading hierarchy (H1 → H2 → H3, no skipping)
Issue: Images not showing in PDF export
Solution: "Use absolute paths for images" or "Embed images inline as base64"
Issue: Code blocks losing formatting
Solution: "Preserve code block syntax highlighting in export" and specify language
Issue: Special characters breaking exports
Solution: "Escape special characters" or "Use UTF-8 encoding throughout"
Issue: Large files causing memory issues
Solution: "Process files in batches" or "Split into smaller sections first"
Show that Markdown Knowledge Base Composer Skill is listed on HeyClaude. Paste this Markdown into your README — it renders the badge and links back to this page.
[](https://heyclau.de/entry/skills/markdown-knowledge-base-composer)
How it compares
Markdown Knowledge Base Composer Skill side by side with 3 alternatives on trust, install, platform support, and disclosed safety notes — all from reviewed registry metadata.
2 trust signals differ across this comparison (Package trust, Source provenance).
ARIS is a Markdown-only skill workflow pack for autonomous ML research agents, with idea discovery, experiment planning, auto-review loops, paper writing, rebuttal, resubmission, slides, posters, Research Wiki, and cross-model reviewer workflows for Claude Code, Codex, OpenClaw, Cursor, and other agent hosts.
MIT-licensed BrowserAct Agent Skill pack for installing and operating the `browser-act` browser automation CLI from Claude Code, Codex, OpenClaw, Cursor, OpenCode, Windsurf, Gemini CLI, and other skills-compatible agents.
Build JavaScript and TypeScript apps with Bun, an all-in-one toolchain that replaces Node.js, npm, a bundler, and a test runner with one fast binary that executes TypeScript directly.
✓Installs npm packages (remark, unified) and runs scripts that read your Markdown files and write composed/transformed output to disk, overwriting files at the target path; review before running on an existing knowledge base.
✓ARIS skills can guide agents through code changes, experiment planning, experiment execution, paper drafting, rebuttal drafting, and cross-model review loops; treat those workflows as high-impact research automation rather than passive documentation.
The `research-pipeline` skill supports auto-proceed modes and reviewer loops. Keep expensive runs, repository mutations, cloud/GPU jobs, and paper-submission decisions behind explicit human approval.
Cross-model review through Codex MCP, Claude-review, Gemini-review, or similar reviewer adapters is a quality-control signal, not scientific proof or peer review.
Generated claims, citations, tables, plots, ablations, rebuttals, and paper text need source checks, experiment audits, citation audits, and human scientific review before being relied on or submitted.
Review all copied skills, scripts, MCP server configuration, and reviewer routing before installing them into a sensitive repository or giving them shell, file, web, cloud, or GPU access.
✓BrowserAct can open pages, click, type, upload files, inspect state, capture screenshots, read page text, handle dialogs, export cookies, capture network requests, and operate logged-in browser sessions.
Use BrowserAct only on sites, accounts, and data sources where the user has authorization. Do not use it to evade access controls, violate site terms, scrape disallowed data, or bypass rate limits.
The entry skill declares confirmation gates for browser creation, deletion, local Chrome profile import, proxy/security changes, logins, form submissions, file uploads, and other sensitive operations; preserve those gates in agent workflows.
`solve-captcha` may send the challenge image to BrowserAct's verification-assistance service according to the skill metadata; do not use it with sensitive or unauthorized pages.
`remote-assist` can generate a live handoff URL for a human to take over. Treat that URL as access to the active browser session.
Skill Forge can generate reusable automation skills from explored sites. Review generated scripts, selectors, network assumptions, output schemas, and site authorization before reusing them at scale.
✓Installing Bun globally (`npm install -g bun`) adds a runtime to your system; install from the official npm package or bun.sh and keep it updated.
Bun runs JavaScript/TypeScript with full system access like Node.js; review code before executing it, especially untrusted scripts.
Privacy notes
✓Inputs can include source files, prompts, logs, account metadata, repository details, and operational context that may be sent to the configured AI model.
Redact secrets, customer data, private URLs, credentials, and proprietary implementation details before sharing prompts, reports, or generated artifacts.
✓Research automation can expose unpublished hypotheses, paper drafts, peer-review text, datasets, logs, source code, experiment traces, model outputs, reviewer comments, account names, and GPU or cloud configuration to the selected model providers and MCP tools.
Cross-model review loops may send the same research artifact to multiple providers or local/remote reviewer services depending on configuration.
Research Wiki, traces, generated reports, paper artifacts, and run logs can persist confidential results or private review material on disk.
Do not share confidential reviews, unreleased findings, private datasets, credentials, proprietary code, or submission-sensitive artifacts with external services unless the research and account policies allow it.
✓BrowserAct workflows can expose page content, screenshots, URLs, credentials typed into forms, cookies, browser profiles, uploaded files, downloaded files, network requests, HAR data, session names, browser descriptions, and logs.
The BrowserAct skill metadata states that cookies, login sessions, page content, credentials, and browser profile data stay local, except the CAPTCHA challenge image when `solve-captcha` is invoked.
Chrome-direct and profile import workflows can connect agents to existing local browser state. Treat those modes as account access, not a blank test browser.
Log reports, feedback, Discord support, generated Skill Forge packages, and shared screenshots can leak private browsing or account context if submitted without review.
Managed proxy, stealth browser, and API-key features create additional BrowserAct service dependencies beyond local CLI execution.
✓Bun apps you build can read local files, environment variables, and make network calls like any Node.js app; keep secrets in environment variables and review what your code sends externally.
Prerequisites
Node.js 18+
remark / unified
Playwright (optional for PDF export)
pandoc (optional for DOCX/EPUB export)
A research project, ML paper idea, baseline repository, dataset, review packet, or experiment plan that is appropriate for agent-assisted research automation.
A compatible agent host that can consume Markdown skills, such as Claude Code, Codex, Cursor, OpenClaw, Antigravity, Trae, GitHub Copilot CLI, or a manual prompt workflow.
Model-provider credentials, MCP reviewer configuration, or local model routing only when using cross-model review or external reviewer loops.
Compute budget, GPU quota, experiment sandboxing, version control, and artifact directories before allowing autonomous experiment execution.
Python 3.12 or newer and the uv package manager for the documented CLI install path.
A compatible agent host that can read `SKILL.md` files and execute shell commands.
Chrome or Chromium for local `chrome` and `chrome-direct` browser modes.
A BrowserAct API key only for optional stealth browsers, stealth extraction, managed proxies, and CAPTCHA assistance.
Bun 1.0+ (install with `npm install -g bun`)
macOS, Linux, or WSL
Basic JavaScript/TypeScript knowledge
Node.js-compatible project structure with package.json for dependency management and module resolution