Insights — Article Authoring Guide

This directory holds the daily hiring-insight articles published at https://bluelinesearch.ai/insights/.

File naming

slug-with-hyphens-2026.md

Slug must be lowercase, hyphen-separated, descriptive, and unique. Year suffix is conventional for evergreen vs. dated content.

Required frontmatter

---
title: "The headline that goes on the article and OG card"
excerpt: "One-sentence hook displayed on /insights cards. Aim for 140-180 chars."
category: "Talent Market"
author: "BlueLine Research"
publishedAt: "2026-04-29"
readTime: "6 min read"
tags: ["Labor Market", "Recruiting Strategy"]
industries: ["Healthcare"]
---

industries — required

One to three buckets from this exact list (case-sensitive, ampersands matter):

• Finance & Insurance
• Healthcare
• Technology
• Manufacturing
• Retail & Consumer
• Energy & Utilities
• Construction & Real Estate
• Professional Services
• Cross-Industry

Picking rules:

• Pick Cross-Industry only for macro labor-market pieces that apply to every vertical equally.
• For vertical-specific articles, pick the 1-3 industries the article actually focuses on.
• Never pick more than 3.
• If you skip the field entirely, the article defaults to Cross-Industry at read time — but tag it correctly so it surfaces in vertical-specific filtered views.

category — pick one

Hiring Trends, Compensation, Talent Market, Recruiting Strategy, Economic Impact, Industry Analysis. Anything else falls through to a neutral pill style.

tags — free-form

Searchable keywords. 3-5 is the sweet spot. Distinct from industries — tags are topical (e.g., "AI Layoffs", "Salary Transparency"), industries are vertical buckets.

Body

Standard markdown. The page renders via marked, no MDX. Use ## for sections, **bold** for emphasis, bullet lists for scannable data.

Avoid em-dashes in body copy (project-wide rule for outbound AI-authored content; ASCII hyphens only).

Backfill / fix tags

If you need to retag existing articles:

npx tsx --env-file=.env scripts/backfill-insight-industries.ts          # idempotent, skip already-tagged
npx tsx --env-file=.env scripts/backfill-insight-industries.ts --force  # re-tag everything
npx tsx --env-file=.env scripts/backfill-insight-industries.ts --dry    # preview only

The script uses Claude Haiku to classify each article. ~$0.30 for the full corpus.