# New Content

> Create new Apple II program posts or blog posts for this Jekyll site. Use when the user wants to add a new program, start a new post, create content, or asks about adding programs or blog entries. Use when this capability is needed.

- Skill: `tomevault-io/new-content` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/new-content`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/new-content/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/new-content

---


# Creating New Content

This skill guides you through creating new program posts or blog posts for the Apple II Programs Jekyll site.

## Content Types

**Program Post**: Showcases an Apple II Applesoft BASIC program with source code, screenshot, and description.

**Blog Post**: General updates, announcements, or articles about the site or Apple II topics.

## Quick Start

Ask the user:
1. **Type**: Program or blog post?
2. **Title**: What should it be called?
3. **Date**: Use today's date or a specific date?

For programs, also ask:
4. **Program type**: One-liner or two-liner?
5. **Performance**: Runs OK at 1MHz or slow?
6. **Source code**: Provide the Applesoft BASIC code

---

## Creating a Program Post

### Required Files

| File | Location | Purpose |
|------|----------|---------|
| Post | `docs/programs/_posts/YYYY-MM-DD-slug.md` | Main post file |
| Source | `docs/_includes/src/slug.txt` | Applesoft source code |
| Screenshot | `docs/media/slug.png` or `.gif` or `.jpg` | Full-size image |
| Thumbnail | `docs/media/slug-tn.png` | Thumbnail (smaller version) |

### Post Template

```markdown
---
layout: post
title: Program Title
date: YYYY-MM-DD
description: Brief description of the program
tags: program one-liner 1mhz-ok
author: Lee Fastenau
screenshot: /media/slug.png
thumbnail: /media/slug-tn.png
source: /src/slug.txt
discussion:
    -
        name: Discussion Link Name
        url: https://example.com/link
---

Description of the program and any usage instructions.
```

### Tag Options

| Tag | Description |
|-----|-------------|
| `program` | **Required** for all programs |
| `one-liner` | Program fits on one line |
| `two-liner` | Program fits on two lines |
| `1mhz-ok` | Runs well on 1MHz Apple II |
| `1mhz-slow` | Runs slow on 1MHz (triggers warp mode in emulator) |
| `notable` | Featured/award-winning program |
| `monochrome` | Best viewed in monochrome mode |

### Source File Format

Create `docs/_includes/src/slug.txt` with the raw Applesoft code. Each logical line should be on its own line:

```
0HGR2:FORN=1TO100:HCOLOR=RND(1)*7+1:HPLOTX,Y:NEXT
```

For two-liners, use two lines:

```
0FIRST LINE OF CODE HERE
1SECOND LINE OF CODE HERE
```

---

## Creating a Blog Post

### Post Template

```markdown
---
layout: post
title: Post Title
date: YYYY-MM-DD HH:MM:SS -0700
tags: updates
author: Lee Fastenau
---

Blog post content here.

Use `<!--more-->` to create an excerpt break.
```

### Common Blog Tags

- `updates` - Site updates and announcements
- `emulation` - Emulator-related content

### Including Images

Use the img include:

```liquid
{% include img.html src="/assets/images/post/image-name.png" caption="Image caption" alt="Alt text description" %}
```

### Including Code Snippets

Use the applesoft include:

```liquid
{% capture source_code -%}
0YOUR CODE HERE
{%- endcapture %}{% include applesoft.md src=source_code %}
```

---

## Naming Conventions

- **Slug**: Lowercase, hyphen-separated (e.g., `my-program-name`)
- **Date format**: `YYYY-MM-DD` or `YYYY-MM-DD HH:MM:SS -0700` for specific times
- **Filename**: `YYYY-MM-DD-slug.md`

## Media Guidelines

- **Screenshots**: Use PNG for static, GIF for animated, JPG for photos
- **Thumbnails**: Should be `-tn.png` suffix, smaller version of screenshot
- Place all media in `docs/media/`

---

## Checklist

### Program Post

- [ ] Create post file: `docs/programs/_posts/YYYY-MM-DD-slug.md`
- [ ] Create source file: `docs/_includes/src/slug.txt`
- [ ] Add screenshot: `docs/media/slug.png|gif|jpg`
- [ ] Add thumbnail: `docs/media/slug-tn.png`
- [ ] Frontmatter includes: layout, title, date, description, tags, author, screenshot, thumbnail, source
- [ ] Tags include `program` plus line count and performance tags

### Blog Post

- [ ] Create post file: `docs/_posts/YYYY-MM-DD-slug.md`
- [ ] Frontmatter includes: layout, title, date, tags, author
- [ ] Add images to `docs/assets/images/post/` if needed

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/thelbane) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->