by fblgit
Great work deserves a second life, Bring it in, Make it reusable and Keep the gain. The iteration ends. The value stays. Your next project starts further ahead, powered by ArtifactDataProtocol
Available after the catalog security scan passes.
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM lists this project for discovery and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
# Add to your Claude Code skills
git clone https://github.com/fblgit/artifacts-done-properlyGuides for using data processing skills like artifacts-done-properly.
See how artifacts-done-properly compares with popular alternatives.
artifacts-done-properly vs sprite gen
See comparison
artifacts-done-properly vs hermes agent
See comparison
artifacts-done-properly vs ponytail
See comparison
artifacts-done-properly vs cc switch
See comparison
artifacts-done-properly vs academic research skills
See comparison
artifacts-done-properly vs gtm engineer skills
See comparison
Great work deserves a second life. The iteration ends. The value stays.
Your next project starts further ahead.
Try it: ADP: Catalog v2.1.1 · ADP: Assistant v2.1.1 (claude.ai artifacts).
KnowledgeBase: ADP: KnowledgeBase v2.1.1 · codex version.
Get it now!: Install the plugin, your AI agent will take care of it.
/plugin marketplace add fblgit/artifacts-done-properly
/plugin install artifacts-done-properly@fblgit-adp
/adp setup
Once is setup, we suggest that you publish the catalog under your own account. After that, a good starting point is the assistant template. It includes agent capabilities that allow you to build your app or artifact from the inside, adopt existing artifacts or websites. It is the ideal starting point for a web-application and is the reccomended path.
ADP is a framework and shared library for reusable claude.ai Artifacts. It installs as a Claude skill.
Good work gets a home in a project. Its reusable pieces go into a catalog as kits, each with an interface, declared dependencies and examples. The next page takes them by reference and starts from your best version.
Underneath, every piece of a page is a part with a stable id and a content hash, and one database layout records every change. adp.py prints the exact Artifact and ArtifactData calls to make, so nothing is retyped by hand.
Bring interfaces, records, and artifacts into a project with your agents. Make the useful parts discoverable instead of burying them in a chat.
Every piece gets an address. On ADP, every piece of a page is a part: a block with a stable id, such as triage.keys-table, and a hash of its content. The id never changes once the page is published, so anything that points at it keeps pointing at the right place. That is what makes the page a place to work in rather than a file to replace. A comment anchors to a part id, not to a position on the screen. A change shows up on the part it touched and on every part that contains it.
Every change goes on the record. One ArtifactData layout records every change under a read, hold, publish, record protocol. Before anyone edits, they read the latest version, because a copy from an earlier session may predate other people's work. After they publish, the change is recorded with who made it, the parts it touched and a summary. The page shows the newest of those in its What changed panel.
Your agents work in it with you. The assistant template adds a Work with Claude pane. Pick a block, say what you want (a change, a fix, a design note or a question) and send it. The request is a record on the page, so you can follow it on Requests: queued, seen, working, done. A line in the header says whether a Claude Code session is watching. Without one, Ask now still answers straight away, and anything you send waits in the queue.
Start new, or bring in what you have. A new page starts from a template:
python3 -I <adp skill folder>/scripts/adp.py new assistant my-page
An artifact you already have goes through the adp-adopt road. It wraps each view and section in part markers, checks them, and seeds the record, without changing how the page looks or behaves. That first step alone gives the page part ids and comment anchors.
A kit carries more than pixels: an interface, declared dependencies, and examples another agent can inspect and compose.
More than pixels. Copying a component's look is easy. What gets lost is how it works: what you call, what it needs and how it is meant to be used. On ADP, a kit keeps all three:
Every entry describes itself. Each catalog entry carries one comment at the top of its main file. The first line is its name, the next paragraph says what it is, and tags give the facts. This is the real header of the data table kit, trimmed (kit/table.js):
/**
* Data table
* ...
* @id kit.table
* @group Board kit
* @version 0.1.0
* @summary A table in its own scroll frame with a sticky head, numeric columns, ...
* @requires none
* @provides Kit.table.render, Kit.table.fmt
* @config Kit.table.render(box, opts) | columns [...], rows, group, ...
*/
The entry also lists its files with a role each: here a script, a style and a sample.
Another agent can inspect it. An agent does not have to read the source to use a kit. It can ask:
adp.py kit show kit.table # name, summary, about, tags, files, requires, provides
adp.py kit describe kit.table # the mount signature: needs, provides, requires, files, sample
And compose it, by reference. adp.py take resolves the entries you name and everything they require, dependencies first and each once. It prints a files map that goes straight into the Artifact publish call, and the server copies the files across. Nothing is downloaded, retyped or pasted.
adp.py take CATALOG kit.table
Components use design tokens only, so a theme changes the look without touching the kit files.
A growing catalog gives you more to start from. Refinement becomes an investment you can carry across pages and projects.
More to start from. A page built with ADP does not start from a blank file. The base catalog has 141 entries: components, patterns, charts, layouts, themes, templates and guides. Each one is versioned and hashed file by file. By kind: 53 patterns, 30 charts and visualisations, 27 kit components, 14 themes, 9 layouts, 5 templates, 2 guides and the runtime.
Templates that stack. The three templates build on each other. starter is the shell, the runtime, a welcome view, settings and the What changed panel. assistant adds the Work with Claude pane, the Requests view and presence. default adds every theme, the canvas, 3D and the common kits, taken by reference.
Find it before you rebuild it. Before building something by hand, ask the catalog:
adp.py suggest CATALOG --for "budget table with totals"
It ranks entries by how well they match on tags, name, summary and what they provide, and says why each matched. No model call is involved.
Refinement becomes an investment. When a component has been through rounds of refinement, that work does not have to stay in one page. Once it is in the catalog, the next page takes it by reference and starts from your best version, across pages and projects.
Not there yet: adp.py new --tier full, the tier meant to start a page from the published catalog (it exits with "not available yet"), and a command to add catalog entries. For now, an entry is added by editing files under catalog/kit/ and then running adp_catalog.py build.
Eight real runs with Claude, from setting up ADP to remaking an existing artifact on it. Each one shows a beat of the pitch.
ADP comes in two forms:
The plugin artifacts-done-properly (recommended), for Claude Code (the CLI and the Code tab of the desktop app):
/plugin marketplace add fblgit/artifacts-done-properly
/plugin install artifacts-done-properly@fblgit-adp
/adp setup
adp.skill, a zip, for the Claude desktop app's skill library: take it from the
latest release, open it with the app and click Add to library, then ask your agent to set ADP up.
Requirements, manual steps, the python3 commands, first run, the catalog and updates are in docs/installation.md.
pip install pre-commit && pre-commit install runs ruff (pyflakes errors), SKILL.md frontmatter validation and the catalog sha256 check on every commit, and gitleaks (secrets, whole history) on every push. CI runs the same checks, plus the unit tests and the bundle build. See docs/RELEASING.md for releases.
Apach
artifacts-done-properly is an open-source data processing skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by fblgit. Great work deserves a second life, Bring it in, Make it reusable and Keep the gain. The iteration ends. The value stays. Your next project starts further ahead, powered by ArtifactDataProtocol. It has 50 GitHub stars.
artifacts-done-properly's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/fblgit/artifacts-done-properly" and add it to your Claude Code skills directory (see the Installation section above).
artifacts-done-properly is primarily written in JavaScript. It is open-source under fblgit on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other Data Processing skills you can browse and compare side by side. Open the Data Processing category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh artifacts-done-properly against similar tools.
No comments yet. Be the first to share your thoughts!
Top skills in this category by stars