This skill should be used when working on any design, marketing, copywriting, writing, or communication task — including: "run PFD", "apply PFD", "use Perception-First Design", "do a PFD analysis"…

Custom licenceAuto-check passedWriting & Content

Install Pfd

skills CLI
$ npx skills add skovalik/perception-first-design --skill pfd -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install skovalik/perception-first-design pfd --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/skovalik/perception-first-design.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/pfd .claude/skills/pfd && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pfd
GitHub stars
142
Token cost
~7.3k tokens
SKILL.md length
3,536 words
Files
40 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
Custom licence

At a glance

This skill should be used when working on any design, marketing, copywriting, writing, or communication task — including: "run PFD", "apply PFD", "use Perception-First Design", "do a PFD analysis"…

  • Works in 11 steps: State the Design Problem → Work Each Layer Bottom-Up → Accumulate Requirements → …
  • Tasks that involve Copywriting
  • SKILL.md covers What PFD Is, The Three Modes, The 5-Layer Dependency Stack and The Derivation Protocol, plus 5 more sections
  • Calls python

What it does

Pfd is an agent skill from skovalik/perception-first-design. This skill should be used when working on any design, marketing, copywriting, writing, or communication task — including: "run PFD", "apply PFD", "use Perception-First Design", "do a PFD analysis", "run the derivation protocol"; when designing interfaces, landing pages, emails, ads, or visual systems; when writing or reviewing marketing copy, headlines, CTAs, proposals, pitches, or presentations; when evaluating conversion problems, bounce rates, engagement, or persuasion; when doing brand work, content strategy…

Its SKILL.md is about 7.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 46 other files, including reference files (for example `references/accumulated-learnings.md`, `references/citation-standards.md` and `references/insights-log.md`).

It sits in Writing & Content, covering Copywriting, Landing pages and Proposals and quotes. The repository describes itself as: A 5-layer design methodology grounded in cognitive psychology. ~100 citations. 15 years applied. MIT + CC BY-SA 4.0.

When your agent uses it

  • Tasks that involve Copywriting
  • Tasks that involve Landing pages
  • Tasks that involve Proposals and quotes

Example prompts

  • “run PFD”
  • “apply PFD”
  • “use Perception-First Design”
  • “/pfd”

Workflow steps

11 steps, taken from the step headings in SKILL.md.

  1. State the Design Problem
  2. Work Each Layer Bottom-Up
  3. Accumulate Requirements
  4. Derive the Solution
  5. Test Against Proposals (if any)
  6. Identify the Gap
  7. Restate the question
  8. Walk each layer bottom-up as a descriptive lens
  9. Check for trade-offs
  10. Check for integrative compounds
  11. Format output

What it can do on your machine

Read from SKILL.md and the folder at commit 1704ff6. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • creativecommons.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pfd loads about 7.3k tokens when it runs, and up to ~47k if it reads all its reference files. Until then it costs about 169 tokens; SKILL.md has 3,536 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~169
When it runs · the whole SKILL.md, loaded when a task matches
~7.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~47k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 3,536 words (~7,270 tokens).

“Author: Stefan Kovalik / Aurochs Framework version: 3.6 (2026-04-20). ~100 citations, international research integration, Methodology Siblings section, Cultural Calibration meta-rule, 7 new layer rules across L0–L4 Source of truth: framework/PERCEPTION-FIRST-DESIGN.md — when framework layer descriptions change, update this skill's layer…”

— opening of SKILL.md by skovalik, Custom licence
name
pfd

Read the full SKILL.md on GitHub

Files

SKILL.md and 39 other files (references) in skills/pfd of skovalik/perception-first-design.

  • SKILL.md
  • references/accumulated-learnings.md
  • references/citation-standards.md
  • references/insights-log.md
  • references/learnings/L0/l018-backend-mechanics-as-frontend-complexity.md
  • references/learnings/L1/l011-visual-channel-audit.md
  • references/learnings/L2/l013-keyboard-density-is-l2.md
  • references/learnings/L2/l016-near-miss-color-asymmetry.md
  • references/learnings/L2/l024-aa-constrained-token-ladder.md
  • references/learnings/L3/l023-falsifiability-triad.md
  • references/learnings/L4/l003-pre-send-vs-post-response.md
  • references/learnings/L4/l006-infrastructure-vs-activation.md
  • references/learnings/L4/l008-epistemic-asymmetry.md
  • references/learnings/L4/l022-l4-symmetry-threshold.md
  • … and 26 more

Open the folder on GitHubat commit 1704ff6

Compare with similar skills

Pfd next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Pfd compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pfd this skillskovalik/perception-first-design142—~7.3kAutomated safety check: PassCustom licence
Money Contentiamzifei/show-me-the-money1k—~9.6kAutomated safety check: PassCustom licence
Content Engineindranilbanerjee/digital-marketing-pro8591 repos~8.9kAutomated safety check: PassMIT
Ralph Copywritermuratcankoylan/ralph-wiggum-marketer777—~2.4kAutomated safety check: PassNone
WeChat Account Topic and Title WriterBigPengSays/bigpeng-hot-gzh265—~501Automated safety check: PassMIT
Content Writer Agentmastra-ai/mastra29k—~1.3kAutomated safety check: PassCustom licence

Similar skills

  • Money Content

    iamzifei/show-me-the-money

    Automated content creation pipeline for business growth. An agent skill from iamzifei/show-me-the-money.

    1k GitHub stars~9.6k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Content Engine

    indranilbanerjee/digital-marketing-pro

    Draft marketing content in brand voice — blog posts, ad copy, email sequences, social posts, landing pages, and brand-voice guides — through a gated pipeline (research, outline, draft, fact-check…

    859 GitHub starsUsed in 1 repo~8.9k tokens
    Writing & ContentAuto-check passed
  • Ralph Copywriter

    muratcankoylan/ralph-wiggum-marketer

    A skill your agent uses when the user asks to "analyze my content", "learn my writing style", "research competitors", "find content angles", "improve my blog", "write like me", "embody my brand…

    777 GitHub stars~2.4k tokensUpdated 6 mo ago
    Writing & ContentAuto-check passed
  • WeChat Account Topic and Title Writer

    BigPengSays/bigpeng-hot-gzh

    Produces topic directions and candidate headlines for WeChat official account articles using seven title formulas, without writing the article itself.

    265 GitHub stars~501 tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Content Writer Agent

    mastra-ai/mastra

    Authoring playbook for building agents that draft written content — blog posts, marketing copy, social media posts, newsletters, product descriptions, landing pages, or ad copy.

    29k GitHub stars~1.3k tokensUpdated today
    Writing & ContentAuto-check passed
  • Anti Vibe Writing

    weijt606/anti-vibe-writing

    A skill your agent uses when the user wants to humanize, de-AI, polish, or warm up an AI-generated document, in English or Chinese.

    120 GitHub stars~3.9k tokensUpdated 2 mo ago
    Writing & ContentAuto-check passed

Questions about Pfd

What does Pfd do?

This skill should be used when working on any design, marketing, copywriting, writing, or communication task — including: "run PFD", "apply PFD", "use Perception-First Design", "do a PFD analysis"…. Pfd is an agent skill from skovalik/perception-first-design.

When should I use Pfd?

Pfd fits situations like: tasks that involve Copywriting; tasks that involve Landing pages; tasks that involve Proposals and quotes.

How do I install Pfd in Claude Code?

Run `npx skills add skovalik/perception-first-design --skill pfd -a claude-code`. Or copy the skill folder (skills/pfd in skovalik/perception-first-design) into .claude/skills/pfd in your project. Claude Code loads it when a task matches its description.

How do I install Pfd in Codex?

Run `npx skills add skovalik/perception-first-design --skill pfd -a codex`. Or copy the skill folder (skills/pfd in skovalik/perception-first-design) into .agents/skills/pfd in your project. Codex loads it when a task matches its description.

Can I use Pfd in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add skovalik/perception-first-design --skill pfd -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pfd, .gemini/skills/pfd, .github/skills/pfd and .opencode/skills/pfd in your project.

What does Pfd need to run?

Going by SKILL.md and its folder, Pfd needs the command-line tools its instructions call (python).

Does Pfd access the network?

SKILL.md names 1 domain. As links in the text: creativecommons.org. This is read from the text; nothing was executed.

Is Pfd safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Pfd use?

Pfd has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Pfd use?

About 7.3k tokens (SKILL.md is roughly 29k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 40k tokens, read only when the agent opens those files.

What are the alternatives to Pfd?

Skills that share tags, products or a category with Pfd: Money Content (iamzifei/show-me-the-money, 1k stars), Content Engine (indranilbanerjee/digital-marketing-pro, 859 stars), Ralph Copywriter (muratcankoylan/ralph-wiggum-marketer, 777 stars) and WeChat Account Topic and Title Writer (BigPengSays/bigpeng-hot-gzh, 265 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pfd?

skovalik (a GitHub user) maintains it in skovalik/perception-first-design, which has 142 GitHub stars. The repository was last updated on June 25, 2026.

Source: skovalik/perception-first-design on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.