[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7DEVSDBSS8VHX2MY65NEWDM":3,"skill-same:01M7DEVSDBSS8VHX2MY65NEWDM":51},{"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":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M7DEVSDBSS8VHX2MY65NEWDM","repository-onboarding",null,"Set up or repair Paved in a repository by preparing its project context, adapters and verification profile. Use when the user asks to initialize or onboard Paved, or Paved reports incomplete setup.","andersonmrodrigues\u002Fpaved","andersonmrodrigues","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F13907380?v=4","01M7DEV3FP2VMQZ3FP2FP1TK1C","Anderson Rodrigues","01M7DEV3GC2QAQBW4FMNT98H48",1,"MIT","https:\u002F\u002Fgithub.com\u002Fandersonmrodrigues\u002Fpaved\u002Fblob\u002Fmain\u002Fcore\u002Fskills\u002Fbootstrap\u002Frepository-onboarding\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: repository-onboarding\ndescription: >-\n  Set up or repair Paved in a repository by preparing its project context, adapters and verification profile. Use when the user asks to initialize or onboard Paved, or Paved reports incomplete setup.\n---\n\n# Repository onboarding\n\n## When to use\n\n- A human asks to add Paved to a repository, and `paved init` is unavailable or failed.\n- `.paved\u002F` exists but is missing its manifest or verification profile.\n\nDo not use it to regenerate existing Project Context; that is the generators' job.\n\n## Required context\n\nNone from Paved: there is no Project Context yet. The inputs are the repository's own\nfiles. Everything you learn is a proposal until a human confirms it.\n\n## Preconditions\n\n- A human asked for onboarding. Never create `.paved\u002F` on your own initiative.\n- The working tree is clean, so the onboarding changes can be reviewed as one diff.\n\n## Procedure\n\n1. **Discover the repository.** Activate `context-discovery` and build the repository\n   overview it describes. Nothing is written yet.\n2. **Detect technologies.** Match build and configuration files against each available\n   adapter's `detect` signals. List the matches with the files that triggered them.\n3. **Resolve adapters.** Propose the matching adapters and a Core version range; a human\n   confirms the list. An unmatched technology is recorded as unknown, not guessed.\n4. **Create the manifest.** Write `.paved\u002Fmanifest.yaml` from `templates\u002Fmanifest.yaml`.\n   Create only paths listed in the consumer layout of the Core `manifest.yaml`.\n5. **Draft Project Context.** Run the generators if they are available. Otherwise create\n   feature-map entries only for features a human names, marked `declared`.\n6. **Discover verification.** For each check type, look for the command the repository\n   already uses (build files, CI configuration, contributor documentation). Add it to\n   `.paved\u002Fverification\u002Fprofile.yaml` only after running it once successfully. Record the\n   check types the repository lacks under `unavailable`, with the reason.\n7. **Connect agents.** Add the Paved block to the root `AGENTS.md` from\n   `templates\u002FAGENTS.md`. If the file exists, add the block and change nothing else.\n8. **Create app verification.** When repository evidence shows a runnable user-facing\n   application or command-line interface and no matching `.paved\u002Fskills\u002Fverify-*` guide\n   exists, create one with `core.testing.app-verification` as part of initialization.\n   Preserve any existing guide. A repository without such an interface needs no guide.\n9. **Validate.** Validate every created document against its schema and fix what fails.\n10. Summarize what was created, what was proposed and what is unknown.\n\n## Tools\n\n`core.repository.status` before starting (clean tree) and after (only `.paved\u002F` and `AGENTS.md`\nchanged).\n\n## Rules\n\n`core.quality.unknowns-stay-unknown` is the main risk: onboarding tempts you to describe\nthe project. Write down only what you read in files or observed when running a command.\n\n## Verification\n\nSchema validation of every created document (`static-analysis`); one recorded run of each\ncommand added to the profile.\n\n## Evidence\n\nThe onboarding diff and one check result per profile check.\n\n## Completion criteria\n\n- Manifest and verification profile exist and validate.\n- Every profile check has run at least once, with its result in the evidence.\n- A human has confirmed the adapter list, or it is empty.\n\n## Failure modes\n\n| Failure | Signal | Response |\n|---|---|---|\n| Guessed execution | A Check's Tool capability has no resolved implementation | Resolve the binding or record the check as blocked |\n| Invented context | Context describes behavior not seen in code | Delete the claims; record unknowns |\n| Clobbered entry file | Diff shows changes outside the Paved block | Revert those lines |\n| Adapter chosen by name alone | A technology is assumed from a directory name | Require a `detect` signal or a human decision |\n\n## References\n\nNone. The consumer layout is in the Core `manifest.yaml` (`consumer_layout`).\n","# Repository onboarding\n\n## When to use\n\n- A human asks to add Paved to a repository, and `paved init` is unavailable or failed.\n- `.paved\u002F` exists but is missing its manifest or verification profile.\n\nDo not use it to regenerate existing Project Context; that is the generators' job.\n\n## Required context\n\nNone from Paved: there is no Project Context yet. The inputs are the repository's own\nfiles. Everything you learn is a proposal until a human confirms it.\n\n## Preconditions\n\n- A human asked for onboarding. Never create `.paved\u002F` on your own initiative.\n- The working tree is clean, so the onboarding changes can be reviewed as one diff.\n\n## Procedure\n\n1. **Discover the repository.** Activate `context-discovery` and build the repository\n   overview it describes. Nothing is written yet.\n2. **Detect technologies.** Match build and configuration files against each available\n   adapter's `detect` signals. List the matches with the files that triggered them.\n3. **Resolve adapters.** Propose the matching adapters and a Core version range; a human\n   confirms the list. An unmatched technology is recorded as unknown, not guessed.\n4. **Create the manifest.** Write `.paved\u002Fmanifest.yaml` from `templates\u002Fmanifest.yaml`.\n   Create only paths listed in the consumer layout of the Core `manifest.yaml`.\n5. **Draft Project Context.** Run the generators if they are available. Otherwise create\n   feature-map entries only for features a human names, marked `declared`.\n6. **Discover verification.** For each check type, look for the command the repository\n   already uses (build files, CI configuration, contributor documentation). Add it to\n   `.paved\u002Fverification\u002Fprofile.yaml` only after running it once successfully. Record the\n   check types the repository lacks under `unavailable`, with the reason.\n7. **Connect agents.** Add the Paved block to the root `AGENTS.md` from\n   `templates\u002FAGENTS.md`. If the file exists, add the block and change nothing else.\n8. **Create app verification.** When repository evidence shows a runnable user-facing\n   application or command-line interface and no matching `.paved\u002Fskills\u002Fverify-*` guide\n   exists, create one with `core.testing.app-verification` as part of initialization.\n   Preserve any existing guide. A repository without such an interface needs no guide.\n9. **Validate.** Validate every created document against its schema and fix what fails.\n10. Summarize what was created, what was proposed and what is unknown.\n\n## Tools\n\n`core.repository.status` before starting (clean tree) and after (only `.paved\u002F` and `AGENTS.md`\nchanged).\n\n## Rules\n\n`core.quality.unknowns-stay-unknown` is the main risk: onboarding tempts you to describe\nthe project. Write down only what you read in files or observed when running a command.\n\n## Verification\n\nSchema validation of every created document (`static-analysis`); one recorded run of each\ncommand added to the profile.\n\n## Evidence\n\nThe onboarding diff and one check result per profile check.\n\n## Completion criteria\n\n- Manifest and verification profile exist and validate.\n- Every profile check has run at least once, with its result in the evidence.\n- A human has confirmed the adapter list, or it is empty.\n\n## Failure modes\n\n| Failure | Signal | Response |\n|---|---|---|\n| Guessed execution | A Check's Tool capability has no resolved implementation | Resolve the binding or record the check as blocked |\n| Invented context | Context describes behavior not seen in code | Delete the claims; record unknowns |\n| Clobbered entry file | Diff shows changes outside the Paved block | Revert those lines |\n| Adapter chosen by name alone | A technology is assumed from a directory name | Require a `detect` signal or a human decision |\n\n## References\n\nNone. The consumer layout is in the Core `manifest.yaml` (`consumer_layout`).\n",{"name":5,"description":7},"main","1cd80f05aff924ea609012e864fa5c22c16c7d2d","core\u002Fskills\u002Fbootstrap\u002Frepository-onboarding",0,"https:\u002F\u002Fgithub.com\u002Fandersonmrodrigues\u002Fpaved","https:\u002F\u002Fgithub.com\u002Fandersonmrodrigues","2026-11-14 20:09:28",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add andersonmrodrigues\u002Fpaved --skill repository-onboarding",{"tool":37,"command":38},"bunx","bunx skills add andersonmrodrigues\u002Fpaved --skill repository-onboarding",{"tool":40,"command":41},"pnpm","pnpm dlx skills add andersonmrodrigues\u002Fpaved --skill repository-onboarding","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fandersonmrodrigues\u002Fpaved\u002Fblob\u002Fmain\u002Fcore\u002Fskills\u002Fbootstrap\u002Frepository-onboarding\u002FSKILL.md",true,[45],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"skill.yaml","REFERENCE","参考文档",388,"https:\u002F\u002Fgithub.com\u002Fandersonmrodrigues\u002Fpaved\u002Fblob\u002Fmain\u002Fcore\u002Fskills\u002Fbootstrap\u002Frepository-onboarding\u002Fskill.yaml",[52,59,65,71,77,83],{"skillNo":53,"name":54,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":19},"01M7DFBWJT4T1MPBHTWT19PBEK","sample-skill","Does a sample task. Use when a sample is needed.","https:\u002F\u002Fgithub.com\u002Fandersonmrodrigues\u002Fpaved\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Fvalid\u002Fsample-skill\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M7DFBS6WTK30PBSW4ZS0NPWT","unexplained-contract","https:\u002F\u002Fgithub.com\u002Fandersonmrodrigues\u002Fpaved\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Finvalid\u002Funexplained-contract\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M7DFBPJGG170V9WTMFWY73R4","shell-block","https:\u002F\u002Fgithub.com\u002Fandersonmrodrigues\u002Fpaved\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Finvalid\u002Fshell-block\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7DFBMZYR20JPTXNE5A8EFG6","project-identifier","https:\u002F\u002Fgithub.com\u002Fandersonmrodrigues\u002Fpaved\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Finvalid\u002Fproject-identifier\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M7DFBJ8J533DAKA3FTF54SX3","oversized","https:\u002F\u002Fgithub.com\u002Fandersonmrodrigues\u002Fpaved\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Finvalid\u002Foversized\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M7DFBFAD0RYCRHTZ2JW4RX7E","no-activation","Does a sample task.","https:\u002F\u002Fgithub.com\u002Fandersonmrodrigues\u002Fpaved\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Finvalid\u002Fno-activation\u002FSKILL.md",[],[]]