Docs & Knowledge · nexu-io/html-anything

competitive-teardown

Name: competitive-teardown
Author: nexu-io/html-anything

Positioning map + feature matrix + pricing comparison + opportunity windows: transforms competitor materials into an actionable product decision report.

L1 Basic · Source registration onlyV1 Commit-PinnedDual-pass Audit

Author nexu-ioGitHub nexu-io/html-anything ↗Stars 8827License Apache-2.0（仓库根 LICENSE：Apache License Version 2.0, January 2004；GitHub API spdx_id=Apache-2.0）Commit 553ed98c28

Control levels describe skill capabilities and suggested control measures; they do not represent quality or safety certifications, nor do they dictate usability. Usage decisions rest entirely with users and administrators. Different agent hosts apply varying constraints; do not assume hosts provide automatic protection. Third-party skill copyrights belong to their original authors. Use at your own risk.

1How It Works & Mechanism

The template itself contains no executable code: loader reads frontmatter and body from src/lib/templates/skills/<id>/SKILL.md, and returns body along with example content as LoadedSkill.

next/src/lib/templates/loader.ts

const raw = safeRead(path.join(dir, "SKILL.md"));

What this does: SKILL.md is the sole source of behavior—frontmatter is used for selector rendering (zh_name/emoji/aspect_hint/tags/example_*, etc.), while the entire body serves as the prompt; loader performs no semantic validation and dispatches whatever is written in the template.

The host assembles the prompt in a fixed manner before dispatch: the template body is sandwiched between SHARED_DESIGN_DIRECTIVES and [Input Format]/[User Content].

next/src/lib/templates/shared.ts

Wrap a per-template instruction body with the shared design directives and

What this does: The template only defines 'what this specific deliverable looks like' (layout/rhythm/components), while shared directives enforce cross-template hard constraints—single-file HTML, prohibition of file tools, Tailwind and Google Fonts loaded via CDN, content authenticity, and CJK spacing rules.

Shared directives formulate hard constraints as explicit prohibitions for the agent and enforce a content-driven quantity rule (numbers in templates serve only as reference lower bounds).

next/src/lib/templates/shared.ts

**禁止使用 Write / Edit / MultiEdit / Bash / Create / 任何文件系统工具**。

Later in the same file is another rule: the number of output slides/frames/cards/sections is entirely determined by the actual length and information structure of [User Content]—explaining why templates of this type do not break as content expands: at least one card/section per content chunk, with the template merely providing a layout pool.

Actual execution is performed by the coding agent CLI already installed and logged in on the user's local machine: the host spawns a child process, hands the prompt to it, and streams HTML output from stdout.

next/src/lib/agents/invoke.ts

import { spawn, type ChildProcessWithoutNullStreams } from "node:child_process";

What this does: The template skill only provides prompts; execution capabilities (including code writing and tool execution) come from the host CLI's existing permissions; the skill directory itself contains no script entry points, so grading evaluates only assets within the directory (host behaviors are excluded).

/api/convert is the execution path for templates: it assembles skill.body and user content into a prompt and passes it to invokeAgent.

next/src/app/api/convert/route.ts

prompt = assemblePrompt({ body: skill.body, content, format });

Edit mode uses buildEditPrompt (minimal-diff editing, file tools disabled, requiring direct streaming of the complete HTML), yielding a stable artifact profile: single-file HTML, inline CSS/SVG, and external links restricted solely to fonts and chart libraries explicitly requested by specific templates.

The core of the template is a fixed 9-section structure: from Header, Executive takeaway, Positioning map, all the way to 30/90/180-day Recommended moves; missing sections constitute failure.