Skip to content

article

A published written work — essay, news article, blog post, paper, newsletter. NOT necessarily a social post. “As We May Think” (1945) is an article with no engagement metrics. A blog post shared on HN is both an article AND a post — the skill tags it with both shapes.

article and post are siblings, not parent-child. When something is both (a modern blog post with comments), it gets both tags.

MetadataValue
Pluralarticles
Subtitle fieldauthor
FieldType
wordCountinteger
readingTimeinteger
sectionstring
languagestring
RelationTarget
publisherorganization
publishedInwebsite

External standards this shape draws from or aligns with. See Shape design principles for how prior art informs shape design.

  • schema.org/Article — Our wordCount = wordCount; section = articleSection; language = inLanguage; publisher matches; publishedIn(website) ≈ isPartOf/publisher. readingTime has no direct property (often timeRequired in ISO 8601 duration).
  • JATS (NISO Z39.96, Journal Article Tag Suite) — Scholarly-article XML standard. Our section ≈ /; language ≈ @xml:lang; publisher ≈ . Heavier than needed for non-scholarly content.
  • OpenGraph article:* properties — Web-article metadata in the wild. Our section ≈ article:section; publisher ≈ article:publisher; language ≈ og:locale. No wordCount/readingTime in OG.