From bfe5823b82e1650bfd5ff32364d17ab552413dac Mon Sep 17 00:00:00 2001 From: Alan Wizemann Date: Thu, 23 Apr 2026 19:42:00 +0200 Subject: [PATCH] catalog: rebuild at 2026-04-23T17:41:59Z --- templates/awizemann-template-author/README.md | 46 ++++++++ .../awizemann-template-author/dashboard.json | 33 ++++++ .../awizemann-template-author/index.html | 104 ++++++++++++++++++ templates/catalog.json | 31 ++++++ templates/index.html | 3 +- 5 files changed, 216 insertions(+), 1 deletion(-) create mode 100644 templates/awizemann-template-author/README.md create mode 100644 templates/awizemann-template-author/dashboard.json create mode 100644 templates/awizemann-template-author/index.html diff --git a/templates/awizemann-template-author/README.md b/templates/awizemann-template-author/README.md new file mode 100644 index 0000000..fa4e8d6 --- /dev/null +++ b/templates/awizemann-template-author/README.md @@ -0,0 +1,46 @@ +# Scarf Template Author + +A Hermes skill that teaches your agent how to scaffold a new Scarf project — and, because Scarf's `.scarftemplate` format is symmetric with a live project on disk, how to shape it so you can publish it to the catalog later if you want. + +## What you get + +Installing this template drops a skill at `~/.hermes/skills/templates/awizemann-template-author/scarf-template-author/SKILL.md` and a minimal "how to use" project in a folder of your choice. Every agent that reads the standard `~/.hermes/skills/` directory — Claude Code, Cursor, Codex, Aider, and the rest of the [agents.md](https://agents.md/) family — picks the skill up automatically. + +## How to use it + +After install, open your agent in any directory and say something like: + +- *"Create a new Scarf project that watches the number of open PRs in my GitHub repo."* +- *"Scaffold a Scarf dashboard that tracks daily focus time from my Toggl logs."* +- *"Set up a project that runs a cron job to summarise my inbox each morning."* +- *"Help me author a Scarf template I can share."* + +The agent will ask four or five questions (purpose, data source, cadence, what to display, any secrets) and then write: + +- `/.scarf/dashboard.json` +- `/.scarf/manifest.json` — only if you're going to use a configuration form or want to export later +- `/AGENTS.md` +- `/README.md` +- Optionally a cron job registered via `hermes cron create` (always created paused — you enable it from Scarf's Cron sidebar when ready). + +When it's done, click **+** in Scarf's Projects sidebar and pick the directory. Your dashboard appears. Iterate on it by asking your agent to tweak widgets or add fields. + +## Turning a local project into a shareable template + +Once you're happy with the result, Scarf → Projects → Templates → *Export "<name>" as Template…* produces a `.scarftemplate` anyone can install. The exporter carries the configuration *schema* but never your filled-in values — so your secrets and personal settings stay local. + +## About this template's own dashboard + +The installed project itself is tiny — a single Quick Start text widget and an empty list widget meant to serve as a scratchpad for tracking which scaffolded projects you've created. Its only purpose is to give you a place to land after install and a reminder of the trigger phrases above. The real value is the skill. + +## Reference + +- [Project Templates wiki page](https://github.com/awizemann/scarf/wiki/Project-Templates) — full spec + troubleshooting. +- [`awizemann/site-status-checker`](https://awizemann.github.io/scarf/templates/awizemann-site-status-checker/) — a complete, non-trivial example the skill studies and references. +- Dashboard / configuration schemas are Swift-authoritative at `scarf/scarf/Core/Models/ProjectDashboard.swift` and `scarf/scarf/Core/Models/TemplateConfig.swift` in the Scarf repo. + +## What this template intentionally is not + +- Not an archetype picker. v1 is blank-slate conversational; pre-baked starters (`monitor`, `dev-dashboard`, `personal-log`, etc.) may land in v1.1 once we see what shapes people ask for most often. +- Not a graphical wizard. The conversational agent path is strictly richer than a fixed form, and dogfoods Scarf's agent-first philosophy. +- Not a remote-scaffolding tool. It writes files into a directory on the machine where the agent runs; pair with Scarf's remote-server mode if you want to scaffold onto another box. diff --git a/templates/awizemann-template-author/dashboard.json b/templates/awizemann-template-author/dashboard.json new file mode 100644 index 0000000..63e9bc8 --- /dev/null +++ b/templates/awizemann-template-author/dashboard.json @@ -0,0 +1,33 @@ +{ + "version": 1, + "title": "Template Author", + "description": "A Hermes skill that helps your agent scaffold new Scarf projects — ask in chat, answer a short interview, and land a working dashboard with the right shape to export as a .scarftemplate later. The Scaffolded Projects list below grows as you use the skill.", + "theme": { "accent": "blue" }, + "sections": [ + { + "title": "Quick Start", + "columns": 1, + "widgets": [ + { + "type": "text", + "title": "Ask your agent", + "format": "markdown", + "content": "**This project gives you a skill, not a service.** There are no cron jobs running, no dashboards to maintain. The real value lives at `~/.hermes/skills/templates/awizemann-template-author/scarf-template-author/SKILL.md`.\n\n**Trigger phrases** your agent listens for:\n\n- *\"Create a new Scarf project that watches …\"*\n- *\"Scaffold a dashboard to track …\"*\n- *\"Set up a project that runs a daily check on …\"*\n- *\"Help me author a Scarf template.\"*\n\nThe agent will interview you (purpose → data source → cadence → widgets → config → secrets), write `/.scarf/dashboard.json`, `/.scarf/manifest.json`, `/AGENTS.md`, and `/README.md`, then tell you to click **+** in Scarf's Projects sidebar to register the directory.\n\nWhen you're happy with the result, **Projects → Templates → Export** turns it into a `.scarftemplate` you can share.\n\nSee the [Project Templates wiki page](https://github.com/awizemann/scarf/wiki/Project-Templates) for the full spec." + } + ] + }, + { + "title": "Scaffolded Projects", + "columns": 1, + "widgets": [ + { + "type": "list", + "title": "Projects this skill has built for you", + "items": [ + { "text": "Nothing yet — ask your agent to scaffold a project and it'll optionally log entries here.", "status": "pending" } + ] + } + ] + } + ] +} diff --git a/templates/awizemann-template-author/index.html b/templates/awizemann-template-author/index.html new file mode 100644 index 0000000..fd30d9b --- /dev/null +++ b/templates/awizemann-template-author/index.html @@ -0,0 +1,104 @@ + + + + + + Scarf Template Author — Scarf Templates + + + + + +
+ + + Scarf Templates + + +
+ +
+
+
+

Scarf Template Author v1.0.0

+

Install this to give your agent a skill that scaffolds new Scarf projects — dashboards, optional configuration schemas, cron jobs, and AGENTS.md — from a short conversational interview. Scaffolded projects are usable locally and cleanly exportable as .scarftemplate bundles.

+

+ by Alan Wizemann + awizemann/template-author + developer-tools +

+

metaauthoringskillscaffolding

+
+
+ Install with Scarf + Download .scarftemplate +
+
+ +
+

Live dashboard preview

+

+ Exactly what you'll see inside Scarf after install. Values shown here are + placeholders; the agent updates them each time the cron job runs. +

+
+
+ +
+
+
+ +
+

README

+
+
+
+ + + + + + + diff --git a/templates/catalog.json b/templates/catalog.json index 7abaeb5..f303b5d 100644 --- a/templates/catalog.json +++ b/templates/catalog.json @@ -63,6 +63,37 @@ "configurable" ], "version": "1.1.0" + }, + { + "author": { + "name": "Alan Wizemann", + "url": "https://github.com/awizemann" + }, + "bundleSha256": "670b2e07ad9bb327c11fa64db1beacf86614a3d388de6fe6e2a19ac957e1346b", + "bundleSize": 13889, + "category": "developer-tools", + "config": null, + "contents": { + "agentsMd": true, + "dashboard": true, + "skills": [ + "scarf-template-author" + ] + }, + "description": "Install this to give your agent a skill that scaffolds new Scarf projects \u2014 dashboards, optional configuration schemas, cron jobs, and AGENTS.md \u2014 from a short conversational interview. Scaffolded projects are usable locally and cleanly exportable as .scarftemplate bundles.", + "detailSlug": "awizemann-template-author", + "id": "awizemann/template-author", + "installUrl": "https://raw.githubusercontent.com/awizemann/scarf/main/templates/awizemann/template-author/template-author.scarftemplate", + "minHermesVersion": null, + "minScarfVersion": "2.2.0", + "name": "Scarf Template Author", + "tags": [ + "meta", + "authoring", + "skill", + "scaffolding" + ], + "version": "1.0.0" } ] } diff --git a/templates/index.html b/templates/index.html index c091574..3673911 100644 --- a/templates/index.html +++ b/templates/index.html @@ -23,7 +23,7 @@

Pre-packaged projects for Scarf

- Browse 1 community template — each ships with a + Browse 2 community templates — each ships with a ready-to-install Scarf dashboard, a cross-agent AGENTS.md, optional cron jobs and skills. Click a template to see what it does; one click installs it into Scarf. @@ -33,6 +33,7 @@

Site Status Checker

A daily uptime check for a list of URLs you configure on install. Writes status to status-log.md and updates the dashboard with current counts.

Alan Wizemannv1.1.0
monitoringuptimecronstarterconfigurable
 +

Scarf Template Author

Install this to give your agent a skill that scaffolds new Scarf projects — dashboards, optional configuration schemas, cron jobs, and AGENTS.md — from a short conversational interview. Scaffolded projects are usable locally and cleanly exportable as .scarftemplate bundles.

Alan Wizemannv1.0.0
metaauthoringskillscaffolding