[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EJ9GKPFJSWVMY9972GE0MB":3,"skill-same:01M7EJ9GKPFJSWVMY9972GE0MB":88},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":5,"forksCount":14,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":6,"ownerDescription":28,"updatedAt":29,"install":30,"resources":43},"01M7EJ9GKPFJSWVMY9972GE0MB","install-prompt-authoring",null,"Create install with a prompt: generate a ready-to-paste install prompt for the README plus AI-executor install docs (`docs\u002FINSTALL-PROMPT.md`) in any project, any ecosystem (pi, npm, Homebrew, pip, cargo, ...), after a mandatory gate that checks whether the owner already has an `INSTALL.md`. Use when the user says \"create install with a prompt\", \"bikin install dengan prompt\", or asks for a preset prompt their users can paste into an AI to install the project, together with docs that AI executes (dependency check, ask-first, enable config, verify, refusal paths). Not for writing human-facing install docs or the project's own INSTALL.md, not for running the install itself, and not for general README work unrelated to an install prompt.","birugh\u002Fbiru-skills","birugh","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F151170580?v=4","01M7EJ9F4MQVSG4EVKCJ7REZZW","biru","01M7EJ9F55MZ2851JWE84ETPDZ",0,"MIT","https:\u002F\u002Fgithub.com\u002Fbirugh\u002Fbiru-skills\u002Fblob\u002Fmain\u002Finstall-prompt-authoring\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: install-prompt-authoring\ndescription: >-\n  Create install with a prompt: generate a ready-to-paste install prompt for the README plus AI-executor install docs (`docs\u002FINSTALL-PROMPT.md`) in any project, any ecosystem (pi, npm, Homebrew, pip, cargo, ...), after a mandatory gate that checks whether the owner already has an `INSTALL.md`. Use when the user says \"create install with a prompt\", \"bikin install dengan prompt\", or asks for a preset prompt their users can paste into an AI to install the project, together with docs that AI executes (dependency check, ask-first, enable config, verify, refusal paths). Not for writing human-facing install docs or the project's own INSTALL.md, not for running the install itself, and not for general README work unrelated to an install prompt.\nlicense: MIT\n---\n\n# Install prompt authoring\n\nCreate an \"Install with a prompt\" README section plus AI-executor install docs for a target project. The prompt is paste-ready and points an AI at the docs; the docs are written **for the AI executor, not for a human** running a shell script.\n\nTwo artifacts, always understood as a pair:\n\n- README section `### Install with a prompt` — a short blockquote prompt the user pastes into their AI.\n- `docs\u002FINSTALL-PROMPT.md` — the instructions that AI executor follows: dependency check, ask-first before installing, enable config, verify, refusal paths, security note.\n\n## Workflow\n\nFollow in order. Each stage ends on its completion criterion.\n\n### 1. Gather target context\n\nRead the target project to learn its ecosystem before writing anything: package manifest (`package.json`, `pyproject.toml`, `Cargo.toml`, `go.mod`, ...), existing README, existing install docs, config files.\n\nDerive from context, never from memory:\n\n- the detection command (`pi list` vs `npm ls -g` vs `brew list` vs `pip list`, ...)\n- config paths and scopes the project actually uses\n- reload\u002Frestart facts (new session, `source`, service restart, ...)\n- what \"installed and working\" means for this project\n\n- Done when: you can name the detection command, the config location, and the verification step for this project.\n\n### 2. Gate: check for the owner's `INSTALL.md` (mandatory — never skip)\n\nCheck whether the repo already has an `INSTALL.md` (repo root or `docs\u002F`). \n\n**If it does NOT exist:** generate `docs\u002FINSTALL-PROMPT.md` from scratch (Stage 3). No question needed — there is nothing to reconcile with.\n\n**If it DOES exist:** you must ask the user which of these three options to take. Do not pick for them, do not skim past it, do not generate first and ask later:\n\n1. **Pakai yang ada (use the existing one)** — no new file. The README prompt points at the owner's `INSTALL.md`. No redundancy; `docs\u002FINSTALL-PROMPT.md` is not created.\n2. **Ada tambahan (there are additions)** — generate `docs\u002FINSTALL-PROMPT.md` containing only the *additional* instructions the user supplies, written in AI-executor format and explicitly referring to the owner's `INSTALL.md` as the base.\n3. **Dibedakan (differentiate them)** — ask back: \"mau dibedakan bagian apanya?\" (which parts should differ?). If the answer is the cliché \"INSTALL-PROMPT.md is for the AI, INSTALL.md is for regular users\", accept it and build `docs\u002FINSTALL-PROMPT.md` as a separate document for its own audience, referencing `INSTALL.md` for the rest. If the answer is something more specific, dig into what they actually mean before writing.\n\n- Done when: existing `INSTALL.md` checked, and (if found) the user answered — recorded as the chosen option.\n\n### 3. Generate the artifacts\n\n**README section** — append `### Install with a prompt`:\n\n- If the README exists but has no such section, append only this section — do not restructure the rest.\n- If the README does not exist, create it containing **only** this section (no other sections invented).\n- Shape (adapt to project tone):\n\n```markdown\n### Install with a prompt\n\nPrefer to let your AI do it? Paste this prompt into `\u003Charness>`:\n\n> Install `\u003Cproject>` for me. First read [docs\u002FINSTALL-PROMPT.md](docs\u002FINSTALL-PROMPT.md)\n> from the repository and follow it exactly. Check my environment with `\u003Cdetection command>`,\n> ask me before installing anything I do not have, complete the config described there,\n> and verify at the end. Do not loosen any guardrail mentioned in those docs.\n```\n\nWhen the gate chose option 1, the prompt links the owner's `INSTALL.md` instead and no docs file is created.\n\n**`docs\u002FINSTALL-PROMPT.md`** — create `docs\u002F` if missing. Written for the AI executor, in imperative second person. Required parts:\n\n- **What this is \u002F who reads it** — the README points here; the executor reads this file first and runs it step by step.\n- **Dependency check** — table or list of what is required, the detection command for this ecosystem, and the rule: read the output, do not guess.\n- **Ask-first before install** — anything missing gets asked about, never silently installed.\n- **Config** — paths, scopes, the exact value that activates the feature; merge, never clobber.\n- **Verify** — concrete end-state checks, plus the reload\u002Frestart fact.\n- **Refusal paths** — situations where the right move is to stop and report, not to \"fix\" the failure by loosening a guardrail or config. Never weaken guardrails to make an install succeed.\n- **Security note** — what gets loaded with what permissions; point the user at the source before installing anything privileged.\n\nOption 2 output instead contains only the user's additions, in the same AI-executor format, referring to the owner's `INSTALL.md` for everything else.\n\n- Done when: both artifacts (or just the README, for option 1) exist and contain their required parts.\n\n### 4. Verify (barrier before finishing)\n\nCheck every line before reporting done; a failed line means fix it first:\n\n- Gate actually ran; if `INSTALL.md` existed, the chosen option and the user's answer are reflected in the output.\n- README section exists and links the correct doc (`docs\u002FINSTALL-PROMPT.md` or the owner's `INSTALL.md` per the gate choice).\n- When the README was created new, it contains only the install-prompt section.\n- `docs\u002FINSTALL-PROMPT.md` includes ask-first, config, verify, refusal paths, and the security note.\n- Every command and path comes from the target project's actual ecosystem — no placeholder like \"run the appropriate command\".\n- Nothing was installed, enabled, or modified in the target project while authoring (unless the user separately asked for that).\n\n- Done when: every bar passes.\n\n## Length\n\nWrite concise, complete instructions — not for a fixed character budget. No minimal-word quotas, no padding to hit a length: judge by completeness of the required parts, not by size.\n\n## Language\n\nDiscuss and write in the language the user uses; the generated prompt and docs follow the target project's own README language.","# Install prompt authoring\n\nCreate an \"Install with a prompt\" README section plus AI-executor install docs for a target project. The prompt is paste-ready and points an AI at the docs; the docs are written **for the AI executor, not for a human** running a shell script.\n\nTwo artifacts, always understood as a pair:\n\n- README section `### Install with a prompt` — a short blockquote prompt the user pastes into their AI.\n- `docs\u002FINSTALL-PROMPT.md` — the instructions that AI executor follows: dependency check, ask-first before installing, enable config, verify, refusal paths, security note.\n\n## Workflow\n\nFollow in order. Each stage ends on its completion criterion.\n\n### 1. Gather target context\n\nRead the target project to learn its ecosystem before writing anything: package manifest (`package.json`, `pyproject.toml`, `Cargo.toml`, `go.mod`, ...), existing README, existing install docs, config files.\n\nDerive from context, never from memory:\n\n- the detection command (`pi list` vs `npm ls -g` vs `brew list` vs `pip list`, ...)\n- config paths and scopes the project actually uses\n- reload\u002Frestart facts (new session, `source`, service restart, ...)\n- what \"installed and working\" means for this project\n\n- Done when: you can name the detection command, the config location, and the verification step for this project.\n\n### 2. Gate: check for the owner's `INSTALL.md` (mandatory — never skip)\n\nCheck whether the repo already has an `INSTALL.md` (repo root or `docs\u002F`). \n\n**If it does NOT exist:** generate `docs\u002FINSTALL-PROMPT.md` from scratch (Stage 3). No question needed — there is nothing to reconcile with.\n\n**If it DOES exist:** you must ask the user which of these three options to take. Do not pick for them, do not skim past it, do not generate first and ask later:\n\n1. **Pakai yang ada (use the existing one)** — no new file. The README prompt points at the owner's `INSTALL.md`. No redundancy; `docs\u002FINSTALL-PROMPT.md` is not created.\n2. **Ada tambahan (there are additions)** — generate `docs\u002FINSTALL-PROMPT.md` containing only the *additional* instructions the user supplies, written in AI-executor format and explicitly referring to the owner's `INSTALL.md` as the base.\n3. **Dibedakan (differentiate them)** — ask back: \"mau dibedakan bagian apanya?\" (which parts should differ?). If the answer is the cliché \"INSTALL-PROMPT.md is for the AI, INSTALL.md is for regular users\", accept it and build `docs\u002FINSTALL-PROMPT.md` as a separate document for its own audience, referencing `INSTALL.md` for the rest. If the answer is something more specific, dig into what they actually mean before writing.\n\n- Done when: existing `INSTALL.md` checked, and (if found) the user answered — recorded as the chosen option.\n\n### 3. Generate the artifacts\n\n**README section** — append `### Install with a prompt`:\n\n- If the README exists but has no such section, append only this section — do not restructure the rest.\n- If the README does not exist, create it containing **only** this section (no other sections invented).\n- Shape (adapt to project tone):\n\n```markdown\n### Install with a prompt\n\nPrefer to let your AI do it? Paste this prompt into `\u003Charness>`:\n\n> Install `\u003Cproject>` for me. First read [docs\u002FINSTALL-PROMPT.md](docs\u002FINSTALL-PROMPT.md)\n> from the repository and follow it exactly. Check my environment with `\u003Cdetection command>`,\n> ask me before installing anything I do not have, complete the config described there,\n> and verify at the end. Do not loosen any guardrail mentioned in those docs.\n```\n\nWhen the gate chose option 1, the prompt links the owner's `INSTALL.md` instead and no docs file is created.\n\n**`docs\u002FINSTALL-PROMPT.md`** — create `docs\u002F` if missing. Written for the AI executor, in imperative second person. Required parts:\n\n- **What this is \u002F who reads it** — the README points here; the executor reads this file first and runs it step by step.\n- **Dependency check** — table or list of what is required, the detection command for this ecosystem, and the rule: read the output, do not guess.\n- **Ask-first before install** — anything missing gets asked about, never silently installed.\n- **Config** — paths, scopes, the exact value that activates the feature; merge, never clobber.\n- **Verify** — concrete end-state checks, plus the reload\u002Frestart fact.\n- **Refusal paths** — situations where the right move is to stop and report, not to \"fix\" the failure by loosening a guardrail or config. Never weaken guardrails to make an install succeed.\n- **Security note** — what gets loaded with what permissions; point the user at the source before installing anything privileged.\n\nOption 2 output instead contains only the user's additions, in the same AI-executor format, referring to the owner's `INSTALL.md` for everything else.\n\n- Done when: both artifacts (or just the README, for option 1) exist and contain their required parts.\n\n### 4. Verify (barrier before finishing)\n\nCheck every line before reporting done; a failed line means fix it first:\n\n- Gate actually ran; if `INSTALL.md` existed, the chosen option and the user's answer are reflected in the output.\n- README section exists and links the correct doc (`docs\u002FINSTALL-PROMPT.md` or the owner's `INSTALL.md` per the gate choice).\n- When the README was created new, it contains only the install-prompt section.\n- `docs\u002FINSTALL-PROMPT.md` includes ask-first, config, verify, refusal paths, and the security note.\n- Every command and path comes from the target project's actual ecosystem — no placeholder like \"run the appropriate command\".\n- Nothing was installed, enabled, or modified in the target project while authoring (unless the user separately asked for that).\n\n- Done when: every bar passes.\n\n## Length\n\nWrite concise, complete instructions — not for a fixed character budget. No minimal-word quotas, no padding to hit a length: judge by completeness of the required parts, not by size.\n\n## Language\n\nDiscuss and write in the language the user uses; the generated prompt and docs follow the target project's own README language.",{"name":5,"license":15,"description":7},"main","64777d60a31ce1e8725f9ba9863f0f941dc39ce0","https:\u002F\u002Fgithub.com\u002Fbirugh\u002Fbiru-skills","https:\u002F\u002Fgithub.com\u002Fbirugh","I'm Biru, an aspiring Software Engineer from Indonesia, building across full-stack development, Linux systems, and DevOps.","2026-10-15 11:20:27",{"source":8,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add birugh\u002Fbiru-skills --skill install-prompt-authoring",{"tool":36,"command":37},"bunx","bunx skills add birugh\u002Fbiru-skills --skill install-prompt-authoring",{"tool":39,"command":40},"pnpm","pnpm dlx skills add birugh\u002Fbiru-skills --skill install-prompt-authoring","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fbirugh\u002Fbiru-skills\u002Fblob\u002Fmain\u002Finstall-prompt-authoring\u002FSKILL.md",true,[44,50,54,58,62,66,70,74,80,84],{"path":45,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":48,"sourceHtmlUrl":49},"eval\u002Ffixtures\u002Fproject-a\u002Fpackage.json","REFERENCE","参考文档",172,"https:\u002F\u002Fgithub.com\u002Fbirugh\u002Fbiru-skills\u002Fblob\u002Fmain\u002Finstall-prompt-authoring\u002Feval\u002Ffixtures\u002Fproject-a\u002Fpackage.json",{"path":51,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":52,"sourceHtmlUrl":53},"eval\u002Ffixtures\u002Fproject-a\u002FREADME.md",194,"https:\u002F\u002Fgithub.com\u002Fbirugh\u002Fbiru-skills\u002Fblob\u002Fmain\u002Finstall-prompt-authoring\u002Feval\u002Ffixtures\u002Fproject-a\u002FREADME.md",{"path":55,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":56,"sourceHtmlUrl":57},"eval\u002Ffixtures\u002Fproject-b\u002FINSTALL.md",240,"https:\u002F\u002Fgithub.com\u002Fbirugh\u002Fbiru-skills\u002Fblob\u002Fmain\u002Finstall-prompt-authoring\u002Feval\u002Ffixtures\u002Fproject-b\u002FINSTALL.md",{"path":59,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":60,"sourceHtmlUrl":61},"eval\u002Ffixtures\u002Fproject-b\u002Fpackage.json",182,"https:\u002F\u002Fgithub.com\u002Fbirugh\u002Fbiru-skills\u002Fblob\u002Fmain\u002Finstall-prompt-authoring\u002Feval\u002Ffixtures\u002Fproject-b\u002Fpackage.json",{"path":63,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":64,"sourceHtmlUrl":65},"eval\u002Ffixtures\u002Fproject-b\u002FREADME.md",156,"https:\u002F\u002Fgithub.com\u002Fbirugh\u002Fbiru-skills\u002Fblob\u002Fmain\u002Finstall-prompt-authoring\u002Feval\u002Ffixtures\u002Fproject-b\u002FREADME.md",{"path":67,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":68,"sourceHtmlUrl":69},"eval\u002Fresults\u002Fqueries-summary.md",1120,"https:\u002F\u002Fgithub.com\u002Fbirugh\u002Fbiru-skills\u002Fblob\u002Fmain\u002Finstall-prompt-authoring\u002Feval\u002Fresults\u002Fqueries-summary.md",{"path":71,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":72,"sourceHtmlUrl":73},"eval\u002Fresults\u002Fscenarios.md",438,"https:\u002F\u002Fgithub.com\u002Fbirugh\u002Fbiru-skills\u002Fblob\u002Fmain\u002Finstall-prompt-authoring\u002Feval\u002Fresults\u002Fscenarios.md",{"path":75,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":78,"sourceHtmlUrl":79},"eval\u002Frun-eval.mjs","SCRIPT","脚本",12657,"https:\u002F\u002Fgithub.com\u002Fbirugh\u002Fbiru-skills\u002Fblob\u002Fmain\u002Finstall-prompt-authoring\u002Feval\u002Frun-eval.mjs",{"path":81,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":82,"sourceHtmlUrl":83},"eval\u002Fscenarios.md",2629,"https:\u002F\u002Fgithub.com\u002Fbirugh\u002Fbiru-skills\u002Fblob\u002Fmain\u002Finstall-prompt-authoring\u002Feval\u002Fscenarios.md",{"path":85,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":86,"sourceHtmlUrl":87},"eval\u002Ftrigger-queries.json",2307,"https:\u002F\u002Fgithub.com\u002Fbirugh\u002Fbiru-skills\u002Fblob\u002Fmain\u002Finstall-prompt-authoring\u002Feval\u002Ftrigger-queries.json",[89,96,103,110],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M7EJACMXCBFFX7DDCY9H8T7G","skill-audit-test","A skill for testing stuff. Helps with test files.","https:\u002F\u002Fgithub.com\u002Fbirugh\u002Fbiru-skills\u002Fblob\u002Fmain\u002Fskill-authoring\u002Feval\u002Ffixtures\u002Fskill-audit-test\u002FSKILL.md",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":19},"01M7EJA7YGTDH7E873WVZPCJX6","foo-skill","Use this skill whenever a Markdown table needs to be made clean and readable: align columns, pad cells, and normalize spacing and pipe indentation so every column lines up consistently. Use it even when the user never says \"format\": they paste a table with ragged, uneven, or broken-looking columns; ask to fix, tidy, prettify, rapiin, or align it; write in Indonesian (\"tabel ini berantakan, rapiin dong\", \"rapikan tabel ini\"); or report that their Markdown table renders badly. Not for generating table content, editing or sorting data, explaining Markdown syntax in general, or formatting tables in non-Markdown formats (CSV, HTML, AsciiDoc).","https:\u002F\u002Fgithub.com\u002Fbirugh\u002Fbiru-skills\u002Fblob\u002Fmain\u002Fskill-authoring\u002Feval\u002Ffixtures\u002Ffoo-skill\u002FSKILL.md",[],[],{"skillNo":104,"name":105,"nameZh":6,"description":106,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":19},"01M7EJ9Z57EHVGDG98JDTG9TRP","skill-authoring","Create, audit, fix, and evaluate Agent Skills — the agentskills.io format (a folder with SKILL.md: frontmatter name\u002Fdescription, instructions, optional references\u002Fscripts) — so they meet the official specification and actually work. Use when making an Agent Skill from an expertise, procedure, or workflow (\"buat skill untuk X\", \"turn our release process into an Agent Skill\", \"jadikan ini skill\"); auditing or fixing an existing skill against the official spec (frontmatter, naming, length, references, instruction quality); or testing whether a skill activates when it should and behaves as intended (trigger queries, behavior scenarios, with\u002Fwithout baseline). Also use when a skill is being written inside the knowledge-to-agent-instructions flow: own the skill artifact per this spec, do not re-decide component choice. Not for deciding which component knowledge becomes (AGENTS.md, supervisor rule, subagent) — that is knowledge-to-agent-instructions; not for generic documentation.","https:\u002F\u002Fgithub.com\u002Fbirugh\u002Fbiru-skills\u002Fblob\u002Fmain\u002Fskill-authoring\u002FSKILL.md",[],[],{"skillNo":111,"name":112,"nameZh":6,"description":113,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":114,"categories":115,"keywords":116,"publishedAt":19},"01M7EJ9QDQSRCSGVDADNJWP56H","knowledge-to-agent-instructions","Turn a user's knowledge — best practices, standards, conventions, hard-won experience — into instructions AI agents actually follow: AGENTS.md, pi-tool-supervisor rules, Agent Skills, and pi-subagents. Use when a discussion or implementation reaches a conclusion worth capturing (\"so the way to do X is Y — that should be the rule\", \"berarti best practice-nya begini, jadikan aturan\"), when the user asks to formalize a standard, convention, or lesson into agent instructions, or when they want knowledge applied to future agent work. Also use when asked to adopt or enforce a specific standard or practice whose purpose is not stated — clarify the purpose before designing. Not for general documentation, code review, or anything outside those four components. When triggered by a newly reached conclusion, offer once to capture it as durable knowledge and wait for the answer — never execute immediately, and never re-offer the same conclusion after it was declined or already captured.","https:\u002F\u002Fgithub.com\u002Fbirugh\u002Fbiru-skills\u002Fblob\u002Fmain\u002Fknowledge-to-agent-instructions\u002FSKILL.md",[],[]]