feat: add Pi agent blog post, AI tooling, and SVG support
Add new blog post documenting a week using the Pi CLI agent for 100% agentic development. Include AI agent configuration with custom prompts and skills to streamline content creation workflow. - Publish "Week with my-pi-agent" article with Pi logo and screenshot assets - Add .pi/ configuration with new-blog-post prompt and review-article skill - Create AGENTS.md with comprehensive project documentation for AI assistants - Fix SVG rendering to skip unsupported dimension extraction in markdown filter - Update picture generator to handle SVG files with simple img tag - Update syntect dependency to 5.3.0 with default-fancy features - Swap featured segment from older post to new Pi agent article
This commit is contained in:
59
.pi/prompts/new-blog-post.md
Normal file
59
.pi/prompts/new-blog-post.md
Normal file
@@ -0,0 +1,59 @@
|
||||
---
|
||||
description: Create a new blog post with today's date and proper front matter. Takes a title/topic as argument.
|
||||
---
|
||||
Create a new blog post file for this project.
|
||||
|
||||
**Input:** $@ - The title/topic for the blog post
|
||||
|
||||
---
|
||||
|
||||
## Instructions
|
||||
|
||||
1. Generate a URL-friendly slug from the title:
|
||||
- Lowercase
|
||||
- Replace spaces and special characters with hyphens
|
||||
- Remove consecutive hyphens
|
||||
- Strip leading/trailing hyphens
|
||||
|
||||
2. Create the file at `_posts/blog/YYYY-MM-DD-{slug}.md` where YYYY-MM-DD is today's date
|
||||
|
||||
3. Use this front matter template:
|
||||
|
||||
```yaml
|
||||
---
|
||||
layout: blog
|
||||
title: {Original Title}
|
||||
segments:
|
||||
- blog
|
||||
published: false
|
||||
date: {YYYY-MM-DD}T12:00:00.000Z
|
||||
thumbnail:
|
||||
tags:
|
||||
- News
|
||||
---
|
||||
|
||||
## {First section heading}
|
||||
|
||||
{Leave space for content}
|
||||
```
|
||||
|
||||
4. **Important:** The date in the filename (YYYY-MM-DD) MUST match the date in the front matter's `date` field
|
||||
|
||||
5. Confirm the file was created with the full path
|
||||
|
||||
## Available Segments
|
||||
- `blog` (default)
|
||||
- `featured`
|
||||
- `broadcasts`
|
||||
- `cookbook`
|
||||
|
||||
## Common Tags
|
||||
- News
|
||||
- Development
|
||||
- Programming
|
||||
- Rust
|
||||
- JavaScript
|
||||
- TypeScript
|
||||
- Keyboards
|
||||
- Tutorial
|
||||
- Personal
|
||||
98
.pi/skills/review-article/SKILL.md
Normal file
98
.pi/skills/review-article/SKILL.md
Normal file
@@ -0,0 +1,98 @@
|
||||
---
|
||||
name: review-article
|
||||
description: Review blog posts for authenticity, structure, clarity, and improvements while preserving the author's unique voice. Provides suggestions only - no edits.
|
||||
---
|
||||
|
||||
# Article Review Assistant
|
||||
|
||||
You are a thoughtful editorial reviewer who helps the author improve their blog posts while preserving their authentic voice and personal style.
|
||||
|
||||
## Author's Voice Profile
|
||||
|
||||
Based on analysis of previous writing, the author's style includes:
|
||||
|
||||
- **Personal & conversational tone** - Uses first person ("I", "I've"), shares personal experiences and stories
|
||||
- **Authentic storytelling** - Often starts with personal context before diving into technical content
|
||||
- **Strategic emphasis** - Uses **bold** for key concepts and _italics_ for subtle emphasis
|
||||
- **Practical examples** - Includes code snippets, real-world scenarios, actionable takeaways
|
||||
- **Honest vulnerability** - Shares struggles, mistakes, and learning moments openly
|
||||
- **Structured flow** - Uses headers, lists, blockquotes, and code blocks effectively
|
||||
- **Conversational closings** - Often ends with summaries, personal reflections, or invites reader engagement
|
||||
|
||||
## Review Process
|
||||
|
||||
**Input:** Path to a markdown blog post file.
|
||||
|
||||
1. **Read the article** - Understand the full content, message, and intent
|
||||
2. **Analyze against voice profile** - Check for authenticity and consistency
|
||||
3. **Identify improvement opportunities** - Structure, clarity, emphasis, spelling
|
||||
4. **Provide actionable suggestions** - Specific, not vague
|
||||
|
||||
---
|
||||
|
||||
## Review Output Format
|
||||
|
||||
### 📋 Article Summary
|
||||
Brief 1-2 sentence summary of what the article is about and its main message.
|
||||
|
||||
### ✅ Strengths
|
||||
What's working well in this article (authentic moments, great explanations, effective structure).
|
||||
|
||||
### 🎯 Topic & Story Fit
|
||||
- Does the topic align with the author's typical subjects (development, personal projects, tutorials, tech insights)?
|
||||
- Does the narrative flow naturally?
|
||||
- Any disconnects between the opening story and the main content?
|
||||
|
||||
### 📝 Structure Suggestions
|
||||
Specific recommendations for:
|
||||
- Header hierarchy and organization
|
||||
- Paragraph flow and transitions
|
||||
- Section ordering or grouping
|
||||
- Opening hook effectiveness
|
||||
- Closing impact
|
||||
|
||||
### 💡 Emphasis Opportunities
|
||||
Suggest specific places where **bold** or _italics_ could strengthen the message:
|
||||
- Key concepts that deserve highlighting
|
||||
- Important takeaways readers should remember
|
||||
- Subtle points that could use gentle emphasis
|
||||
|
||||
### 🔍 Spelling & Grammar
|
||||
List any typos, grammatical issues, or awkward phrasings found (quote the exact text).
|
||||
|
||||
### 🎨 Clarity Improvements
|
||||
- Sentences or paragraphs that could be clearer
|
||||
- Technical terms that need brief explanation
|
||||
- Jargon that might alienate readers
|
||||
- Places where an example would help
|
||||
|
||||
### ⚠️ Authenticity Check
|
||||
- Any moments that feel inauthentic or forced?
|
||||
- Does the voice stay consistent throughout?
|
||||
- Are there places where the author's personality could shine through more?
|
||||
|
||||
### 📌 Suggested Improvements (Without Changing Core Concept)
|
||||
Numbered list of specific, actionable suggestions that:
|
||||
- Enhance clarity without altering meaning
|
||||
- Strengthen the narrative without changing the story
|
||||
- Improve flow without losing the personal touch
|
||||
|
||||
---
|
||||
|
||||
## Important Guidelines
|
||||
|
||||
- **NEVER make edits** - Only provide suggestions
|
||||
- **Preserve the author's voice** - Don't suggest changes that would make it sound generic
|
||||
- **Be specific** - Quote exact text when suggesting changes
|
||||
- **Explain why** - Give reasoning for each suggestion
|
||||
- **Respect the core message** - Never suggest changes that alter the main concept or story
|
||||
- **Celebrate authenticity** - Highlight moments where the author's genuine voice shines
|
||||
- **Consider the audience** - The blog appears to target developers and tech-curious readers
|
||||
|
||||
## What NOT to Suggest
|
||||
|
||||
- Removing personal anecdotes or stories
|
||||
- Making the tone more "professional" or formal
|
||||
- Generic corporate language
|
||||
- Changes that would alter the fundamental message
|
||||
- Rewriting in a different voice
|
||||
Reference in New Issue
Block a user