# New Promoted

> Creates a new promoted card in src/content/promoted/ with valid frontmatter and ordering. Use when adding a featured item, call-to-action, or highlighted content to the homepage.

- Skill: `majiayu000/new-promoted` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/new-promoted`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/new-promoted/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/new-promoted

---


Create a new promoted/featured card in the `src/content/promoted/` directory.

## Steps

1. Take the title from the user's argument. If not provided, ask for one.
2. Generate a kebab-case filename from the title.
3. Read existing promoted items in `src/content/promoted/` to determine the next `order` number (highest existing order + 1, or 1 if none exist).
4. Ask the user for:
   - **Description** — keep under 120 characters
   - **Link URL** — destination when the card is clicked
   - **Link text** — CTA button text (e.g., "Learn more", "View project")
   - **Image URL** — card image
5. Create `src/content/promoted/<slug>.md`:

```markdown
---
title: "<title>"
description: "<description>"
image: "<image URL>"
link: "<link URL>"
linkText: "<link text>"
order: <next order number>
publishedAt: <today's date YYYY-MM-DD>
---
```

6. Tell the user:
   - The file was created at `src/content/promoted/<slug>.md`
   - The `order` field controls display order on the homepage (lower = first)
   - Keep title under 60 characters and description under 120 characters
   - All fields are required for promoted cards