skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
doodledood/manifest-dev64 installs

product-principles

Product principles for manifest-dev: how its maintainer wants calls about what the plugin does for its users made, and why. Use before planning, designing, building or reviewing a skill step, a mode, a default or an offer that manifest-dev ships.

How do I install this agent skill?

npx skills add https://github.com/doodledood/manifest-dev --skill product-principles
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill consists of product development guidelines and principles for AI agents. It does not include any code, external dependencies, or network operations, and presents no security risks.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Edit rule: each line is a principle with its reason and when it yields. Decisions go to the decision records, rules a check can hold go to the check, and a line is added only on a person's yes, after sharpening an existing line is ruled out.

  • When a call shapes behavior manifest-dev ships — a skill step, a mode, a default, an offer — prefer a sensible default every user gets with no setup, changeable through channels people already use (their stated rules, their context file, their project's own copy of a convention, a note at invocation), worded to hold across the many kinds of project the plugin runs in rather than one project, host or case — in the maintainer's words, "have defaults baked in with options to change and override, and keep things general when possible, since the product here applies to many, many use cases." A mechanism that serves one setup, or whose benefit nobody has isolated, stays out of the shared skill: it adds constraints and complexity every user inherits. Yields when no single default fits a known group of users: let the default follow what the session can see, rather than adding a setting or a question — a person who does not know a flag, mode or skill exists gets the wrong default anyway — and have the run say which it took and why, so plain words change it; and when generalizing would widen the work beyond the job at hand: generalize the wording, not the machinery.
  • Ask a person for, and hand a person, only what is theirs — a cost to weigh, a change to what they agreed, a direction, a choice they kept — and let the run settle the rest and report what it chose and why, so one word redirects it; a run started unattended never asks and never waits, and puts the calls that were the person's first in its report — a person's yes does not scale to many agents, a stalled run costs closer to lost days than the minutes a question takes, and a report that floods stops being read. Yields when going on needs knowledge, access or authority the run lacks, or when a project's own rules ask for a person.
  • Judge a skill step, a default or a new surface by whether it leaves less for a person to do next time: what a person answers once is kept where later runs load it (a principles line, a Taste entry, a decision record, the project's own files) so no run asks it again, and the steps before execution are built to need the person less as that record grows — in the maintainer's words, the goal is "to help minimize the human in the loop as much as we can the more you go up the layers" — an answer that lives only in a conversation is asked again by the next run, and a person's yes does not scale to many agents. Yields for the ends and bounds a person keeps, and for the person's own view, which is written only on their yes.
  • What a skill writes for a person is budgeted by that person's attention: one claim per message, common words, the ask set apart with the answer the run would give, and nothing posted that changes nothing for its reader — no bookkeeping output, no repeat of an unchanged item, no question already answered — a correct message that arrives as a dense wall has not produced shared understanding, and repeats bury what is new. The load comes off how it reads, never off what was investigated. Yields to the person's own style instructions.
  • Size what a skill spends — re-checks, recall, review passes, questions — to what rides on the ask, and write each such rule with the condition it fires under, never "on every run" — on a cheap, reversible ask the check costs more than a miss, and unconditional rigor made small asks worse. Yields when acting on the result would be costly or hard to undo: then full depth.
  • Nothing the workflow relies on may depend on a person remembering to run it, on a schedule, or on infrastructure the user must set up: put it where a step people already run reaches it, and let upkeep ride the normal runs that touch a surface — a pass someone must remember does not run in practice, and nothing fails visibly when it is missing. Yields for an optional extra the workflow never depends on, and for a repair that is a project of its own, which is named as debt.
  • Nothing binds a run that nobody with authority asked for, and nothing a person deliberately required is relaxed by the run that must meet it: a number, proxy or stricter bar an agent introduced stays revisable or becomes a question, and trying, repairing and size are bounded by evidence, never by a count or threshold nobody can source — an invented value read cold becomes a requirement nobody checked, a count misjudges both ways, and a run that may lower its own bar will. Yields when a person states the number: then it binds.
  • What a skill keeps or acts on as the person's own view — a preference, a reason, a principle, a North Star position, a seeded term — is shown to them and written only on their yes to the exact text, or on a yes they gave in advance for a named run, which shows each line it wrote in its report; evidence may lower a line's confidence or flag it, and a run with no person present flags and writes nothing — an inferred reason can only be obeyed, not weighed, and it stops the pushback that would correct it. Yields when an assignment explicitly delegates that decision; never for an end or a principle.
  • A choice the person will judge by seeing or using it — a look, a flow, a format — reaches them as concrete options or a rendered draft to react to, never decided silently inside a proposal or asked in the abstract — agreement in prose hides divergence, and a wrong concrete thing surfaces disagreement faster than a vague correct sentence. Yields: a rendering is offered, never pushed.
  • When a session's correction shows how a shipped skill should behave, ask whether another user could want the opposite: if not, change the skill, and keep preference files for departing from a default — a fix in one person's memory file travels with the person who complained, not with the skill that misbehaved. Yields when the opposite could suit another user: then it is that person's preference.
  • A review reports what it found and what that costs, graded by consequence shown from evidence; whoever commissioned the work decides what to require. Classification, recommendation and decision stay separate outputs — no raised grade to force a fix, no advice acting as a merge gate — a grade that carries the repair decision changes meaning from caller to caller, and nit loops never converge. Yields when a substantive failure arrives under a low grade: regrade it from evidence before any policy applies.
  • Fewer things ship complete rather than more ship half-done — a person judges the product by its roughest part they meet. Yields for an early version shipped on purpose to learn, which is labelled as one.
  • Before a press that uses up something, makes the person wait long or can never be reversed, the control states what will be consumed and what comes back, and no default spends anything unannounced — a cost found out after the press feels like a trick. Yields when the cost is too small for anyone to weigh.
  • A person is told in words — a message, a document, a release note, a label — that something is finished, measured or included only when it truly is, and a gap is named rather than papered over — once someone catches one untrue claim, they doubt all the rest. Holds without a yield.
  • A product call rests on something people were seen to do — pick, switch, work around, or leave alone — which the change names, and when a direction is good enough it ships and actual use steers the following round — a made-up story or one anecdote cannot show what people want, and live use is the least costly evidence available. Yields while nobody uses the product yet; then the call is named as a bet.
  • Work a person made or earned is never taken away by a refresh, a release, a cancellation or a change of method — losing work they did nothing to lose is where a product does the most harm to the people it serves. Yields to the person's own deliberate act, once its outcome has been stated, and to retention rules that demand deletion, applied with warning and a chance to export first.
  • Total spend on per-use costs has a hard cap and an off switch, placed where sensible use never reaches it, and a person stopped by the cap has their work queued or is told when it will continue — a single loop gone wrong or a single bad actor must not set the bill. Holds without a yield; the cap moves only by the owner's decision.
  • A behavior people rely on changes only with notice they can see before the change lands — a silent change breaks what people built on the old behavior. Yields for removing a behavior that was itself harming people; then the notice follows the fix.
  • Each feature names, before it is built, the observable result that will show it worked and where to read it — without that, a feature that shipped cannot be told from one that works. Yields for a fix restoring a behavior that already had one.

Before calling product work done, check it against these principles from a fresh start — a new session, or a reviewer who did not do the work. Fix what departs unless the person chose the departure, and check again only after a fix, until a check finds none. Name each departure kept, with the principle and why.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/doodledood/manifest-dev/product-principles">View product-principles on skillZs</a>