Creating Articles
Businesscreating-articlesCreating Articles is an Agent Skill for business published in the artsy/artsy.github.io repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Creates new blog posts for the Artsy Engineering blog. Use when the user wants to write, create, or start a new blog post or article.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/artsy/artsy.github.io/blob/HEAD/.claude/skills/creating-articles/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/creating-articles, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Creating Articles
For full documentation, see docs/authoring_articles.md.
Workflow
Step 1: Gather Information
Use AskUserQuestion to ask the user:
-
Template selection - Ask which template they want to use:
regular-post- Short, straightforward posts (recommended for most posts)long-post- Detailed posts with introduction, body, and conclusionepic-post- Narrative-style posts following the monomyth structure
-
Author name - Ask for their name, then check if they exist in
_config.ymlunder theauthors:key.
Step 2: Validate Author
Read _config.yml and search for the author under the authors: section.
If author exists: Use their author key (e.g., orta, db, joey).
If author does not exist: Inform the user they need to add themselves to _config.yml first:
authors:
authorkey:
name: Full Name
github: githubUsername
twitter: twitterHandle # optional
site: https://example.com # optional
Step 3: Create the Post
- Generate filename:
YYYY-MM-DD-post-title.markdown(use today's date) - Copy the selected template from
Post-Templates/to_posts/ - Update the front matter:
- Set
title - Set
dateto today - Set
authorto the author key - Set
categories(ask user if not provided)
- Set
Templates Reference
| Template | File | Use Case |
|---|---|---|
| Regular | Post-Templates/YYYY-MM-DD-regular-post.markdown | Quick posts about a problem and solution |
| Long | Post-Templates/YYYY-MM-DD-long-post.markdown | Detailed technical deep-dives |
| Epic | Post-Templates/YYYY-MM-DD-epic-post.markdown | Narrative journey-style posts |