# Build Markdown Websites with Vowel

Markdown websites need consistent page structure, navigation, and publishing settings. This skill guides AI assistants through Vowel authoring, validation, previews, exports, and approved deployment.

## Install

```bash
npx skillstore add samlfair/vowel
```

## Metadata

- Status: approved
- Slug: samlfair-vowel
- Skillstore revision: r1
- Version status: missing
- Tree hash: 192ae62d1ce711e341009aa6633701e6207c1cf32ae5d6358be89281fc4567d1
- Author: samlfair
- GitHub username: samlfair
- Repository: https://github.com/samlfair/vowel/tree/37b246f4d13cb7c02ea9b08f1e07a39a1f300cd3/skills/vowel
- Ref: c993c6abcbffafea2683d7748b53b3dfaf438415
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, network, filesystem
- Quality score: 72
- Public page: https://skillstore.pages.dev/skills/samlfair-vowel
- Manifest: https://skillstore.pages.dev/api/skills/samlfair-vowel/manifest

## Capabilities

- Guide creation of Vowel homepages, section indexes, and settings files.
- Apply page metadata conventions for titles, dates, images, descriptions, and publication status.
- Use file links, wikilinks, tags, alerts, and filtered page listings.
- Configure inherited site settings and customize appearance through project stylesheets.
- Guide validation with vowel check and local preview startup.
- Guide static exports and Cloudflare Pages deployment with explicit publication approval.

## Use Cases

- Create a personal Markdown blog: Organize dated posts, section indexes, tags, and feed settings for a personal publishing site.
- Publish selected Obsidian notes: Prepare a public digital garden using wikilinks and page listings while excluding private material before deployment.
- Maintain a documentation website: Structure documentation sections, manage inherited settings, and validate changes before exporting the site.

## Prompt Templates

### Start a simple site

```
Set up a Vowel site named [site name] with home and about pages. Ask before installation and do not deploy.
```

### Add a dated blog post

```
Add a post about [topic] dated [date] to my Vowel blog. Include a description and tags, then run vowel check.
```

### Organize a digital garden

```
Organize [folder] as a Vowel digital garden using wikilinks, section indexes, and tag listings. Identify private content before preparing publication.
```

### Prepare an approved release

```
Review [site folder], fix validation errors, and export to [empty output folder]. Review publication scope and ask before any Cloudflare Pages deployment.
```

## Limitations

- Requires an external Vowel installation or npx execution and Node.js 26 or later.
- Provides instructions only; the reviewed skill does not include the Vowel runtime.
- Vowel drops HTML inside Markdown; generated build output should not be edited.
- Hidden pages and hashed URLs do not protect sensitive content.

## Best Practices

- Run vowel check after each change and resolve every reported problem.
- Prefer file-based page links so links survive URL changes.
- Review publication scope and obtain explicit approval before deployment.

## Anti Patterns

- Editing generated HTML instead of source Markdown and project stylesheets.
- Treating hidden pages or hashed URLs as protection for confidential information.
- Deploying a site without reviewing its content and obtaining approval.

## Security Audit

- Audited at: 2026-11-06T16:22:57.803\+00:00
- Summary: All 41 static findings are false positives involving Markdown formatting, documented Vowel commands, documentation URLs, and a relative page link. No evidence found of prompt injection, credential theft, or unauthorized data transfer in SKILL.md. The Vowel package and linked documentation were not audited.

## Stats

- Views: 0
- Downloads: 0
- Favorites: 1
- Popularity score: 0