paperclip-page

Publish static HTML pages and asset folders to the Paperclip S3/CloudFront page host. Use when asked to deploy, host, or share a persistent page, viewer, prototype, report, or static site without here.now.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A tight, actionable SKILL.md body with a clear validated workflow and strong safety guidance, supported by a real publish.sh bundle script. The main gap is an unresolved README.md reference that should either be included or removed.

Suggestions

Include the referenced README.md in the bundle, or replace the closing pointer with inline operator-setup essentials so no external file is missing.

Tighten the credential-scoping paragraph to a concise rule plus a one-line rationale rather than explaining AWS SDK static-key precedence in full.

Consider briefly noting the update/delete semantics (additive overwrites only, never deletes remote objects) in the description for fuller trigger coverage.

Dimension	Reasoning	Score
Conciseness	Mostly lean and assumes Claude's competence, but the credential-scoping paragraph ("Do not bind the page-uploader credentials as global AWS_ACCESS_KEY_ID...") explains AWS SDK precedence behavior at a length that could be tightened without losing the rule.	4 / 5
Actionability	Provides copy-paste-ready commands for dry-run, publish, and update with concrete flags and example slugs, and an enumerated requirement list, fully covering the common cases.	5 / 5
Workflow Clarity	The publish workflow is clearly sequenced with an explicit dry-run validation checkpoint, an update ownership-proof feedback loop, and a troubleshooting section for error recovery on a destructive/batch operation.	5 / 5
Progressive Disclosure	Well-organized sections with a real referenced bundle script (scripts/publish.sh exists), but "See README.md next to this skill" points to a file not present in the bundle, leaving one reference unresolved.	4 / 5
	Total	18 / 20 Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, well-targeted description that pairs a concrete capability statement with an explicit, natural "Use when" trigger clause and a clear niche. The only improvements are minor: adding synonym/extension triggers and hinting at the update workflow.

Dimension	Reasoning	Score
Specificity	Names the domain and several concrete actions ("Publish static HTML pages and asset folders to the Paperclip S3/CloudFront page host"), with only minor gaps in coverage such as omitting update/delete semantics from the description.	4 / 5
Completeness	Clearly answers both "what" (publish static HTML pages and asset folders to the page host) and "when" via an explicit "Use when asked to deploy, host, or share..." clause with concrete triggers.	5 / 5
Trigger Term Quality	Strong natural trigger phrases ("deploy, host, or share a persistent page, viewer, prototype, report, or static site"), though it lacks file-extension or synonym variants that would push it to a 5.	4 / 5
Distinctiveness Conflict Risk	Targets a clearly distinct niche (the Paperclip S3/CloudFront page host) with specific triggers and an explicit exclusion ("without here.now"), minimizing overlap with other skills.	5 / 5
	Total	18 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: paperclipai/paperclip
Path: .agents/skills/paperclip-page/SKILL.md
Commit: 6d358e6

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.