classify-publisher-patterns

Classify publisher technology and layout patterns into a 15-section taxonomy from HTML.

Updated Aug 23, 2025
One-click install
npx skills add https://github.com/therealityreport/trr-app --skill classify-publisher-patterns
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: classify-publisher-patterns
Source: https://github.com/therealityreport/trr-app/tree/main/.agents/skills/design-docs-agent/classify-publisher-patterns
Command: npx skills add https://github.com/therealityreport/trr-app --skill classify-publisher-patterns

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects publisher pages by identifying the technology stack and mapping layout patterns to a standardized 15-section brand taxonomy to guide pre-extraction decisions and inventory generation.

Core Features & Use Cases

  • Technology detection: Inventory frameworks, CDNs, analytics, and CSS techniques from page HTML.
  • Layout family classification: Assign the page to a layout family (nyt-interactive, nyt-article, athletic-article, generic-publisher).
  • Taxonomy mapping: Produce a PublisherClassification object describing section-level element mappings for downstream pipelines.
  • Use case: Inform which extractors to invoke before the extraction wave and generate a Dev Stack inventory entry for the design-docs pipeline.

Quick Start

Run the classify-publisher-patterns script with the article URL and path to the source HTML to obtain the PublisherClassification.

Frequently Asked Questions about classify-publisher-patterns

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect publisher technology and layout patterns from HTML?

You can detect publisher technology and layout patterns by analyzing page HTML to inventory frameworks, CDNs, and analytics, then mapping the structure to a standardized brand taxonomy for downstream extraction.

What is a publisher layout family classification used for?

Publisher layout family classification assigns pages to categories like nyt-interactive or generic-publisher to drive pre-extraction decisions, informing exactly which data extractors to invoke before processing content.

How do I generate a Dev Stack inventory from a publisher page?

Generate a Dev Stack inventory by running a deterministic script against article URLs and local HTML paths to identify CSS techniques and frameworks, producing a structured object for design docs.

Can I map web-scraping results to a taxonomy without external dependencies?

Yes, you can map web-scraping results to a 15-section taxonomy without external dependencies because the classification relies on a deterministic CLI entrypoint and a structured PublisherClassification type.

Does this publisher pattern detection work with any generic publisher HTML?

Yes, the detection works with generic publisher HTML by assigning unrecognized pages to a generic-publisher layout family while still identifying the underlying tech stack and analytics frameworks.

When should I not use automated taxonomy mapping for pre-extraction?

Avoid automated taxonomy mapping when source HTML is heavily obfuscated or dynamically rendered without static markup, as the deterministic CLI relies on analyzing raw HTML structure to produce consistent classification results.