# Floggy Documentation
> Docs for Floggy, the blog platform. Every page is also available as raw markdown at /docs/<slug>.md, and the full corpus at /docs/llms-full.txt.

## For coding agents: install the Floggy skill

If you are an AI coding agent (Claude Code, Codex, Cursor, and friends) setting up Floggy for a user, install the Floggy skill first so you keep the knowledge of how to publish to and read from their blog:

1. Find the user's agent config directory. It is a `.claude/` or `.agents/` folder, either in the project root (project-local, preferred) or in their home directory (global).
2. Inside it, make sure a `skills/` folder exists. Create it if missing.
3. Inside `skills/`, create a `floggy/` folder.
4. Fetch `/skills/floggy/SKILL.md` and save it verbatim as `skills/floggy/SKILL.md`.

Resulting layout:

```
.claude/skills/floggy/SKILL.md
```

That is all. The skill loads as `floggy` on your next run. It teaches the `floggy` CLI (publish and manage posts, notes, tasks, uploads) and the `@floggy/cms` library (read published content into any site), and points back to these docs for exact commands.

Every action is scoped by an API key the user creates in the dashboard (Settings then Developer), so a key only ever has the access they grant it.

## Getting started

- [Introduction](/docs/introduction.md): Floggy is your corner of the internet. One place to publish writing, show your work, keep your notes and tasks, and l...
- [Quick start](/docs/quickstart.md): This is the fastest path from a fresh signup to a live blog you can share. Plan for a few minutes. You don't need any...
- [Create your blog](/docs/your-blog.md): Your Floggy site is your public presence: your address, your profile, your portfolio sections, and your navigation. T...
- [Writing posts](/docs/writing.md): Writing on Floggy happens in a full-screen editor, not a small box wedged into the dashboard. This guide covers writi...
- [Custom domain](/docs/custom-domain.md): Your blog lives at your-username.floggy.xyz by default. On the Pro tier you can point a domain you own at it instead,...
- [Themes](/docs/themes.md): A theme sets the overall look of your site - its layout, typography, and feel. Floggy ships with a handful of themes,...
- [Calendar & bookings](/docs/calendar.md): Floggy can turn your site into a booking page. Connect your calendar, set your availability, and visitors can grab ti...
- [Analytics](/docs/analytics.md): Floggy has built-in analytics so you can see who's reading without adding a tracking script or wiring up a third-part...

## CMS SDK

- [Overview](/docs/cms.md): @floggy/cms is the single dependency you install to build a blog on Floggy. It returns your content fully typed and r...
- [Quickstart](/docs/cms/quickstart.md): A blog index, a rendered post, and SEO metadata. About 15 lines.
- [SDK reference](/docs/cms/sdk.md): @floggy/cms is a thin, fully typed client for your Floggy content. It fetches your posts, tags, SEO metadata, JSON-LD...
- [Authentication](/docs/cms/authentication.md): Public reads need no auth. You only need a key to read drafts and private content, or to write (create, update, delet...
- [Webhooks](/docs/cms/webhooks.md): Webhooks let an external frontend revalidate when your content changes. Floggy POSTs a small payload to your endpoint...

## For agents

- [SKILL.md](/docs/skill.md): Drop-in skill that teaches a coding agent to publish to Floggy with the CLI and CMS.

## CLI

- [Overview](/docs/cli.md): Headless access to your Floggy blog, notes, tasks, profile, and analytics. Everything you can do in the dashboard plu...
- [Posts & uploads](/docs/cli/posts.md): Manage blog posts from the terminal: list, get, search, create, edit, publish, delete, and export. Includes CLI-only ...
- [Notes](/docs/cli/notes.md): Manage notes, folders, and labels from the terminal. Notes support views, trash, and restore, and organize into folde...
- [Tasks](/docs/cli/tasks.md): Manage tasks, projects, and labels from the terminal. Tasks support statuses, priorities, due dates, and project or l...
- [Analytics](/docs/cli/analytics.md): Read blog metrics and manage co-authors from the terminal. Analytics are available on your account automatically.
- [Recipes](/docs/cli/recipes.md): Scriptable pipe patterns, profile sections and navigation, markdown conversion internals, backdating, and known limit...