{"id":51855820,"url":"https://github.com/next-friday/next-friday-skills","last_synced_at":"2026-07-24T00:30:44.030Z","repository":{"id":364434444,"uuid":"1267892742","full_name":"next-friday/next-friday-skills","owner":"next-friday","description":"Claude Code skills for issue-driven development — design in a GitHub issue, ship a gated PR to green CI, and triage AI code review.","archived":false,"fork":false,"pushed_at":"2026-07-05T07:03:06.000Z","size":253,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-05T09:04:10.198Z","etag":null,"topics":["agent-skills","ai-agents","automation","best-practices","claude","claude-code","code-review","developer-tools","github","issue-driven-development","issues","pull-requests","tdd","workflow"],"latest_commit_sha":null,"homepage":"https://skills.sh/next-friday/next-friday-skills","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/next-friday.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-13T00:28:01.000Z","updated_at":"2026-07-05T07:03:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"bcb10bec-a38a-48d3-930e-b13ed1588425","html_url":"https://github.com/next-friday/next-friday-skills","commit_stats":null,"previous_names":["next-friday/next-friday-skills"],"tags_count":24,"template":false,"template_full_name":null,"purl":"pkg:github/next-friday/next-friday-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/next-friday%2Fnext-friday-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/next-friday%2Fnext-friday-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/next-friday%2Fnext-friday-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/next-friday%2Fnext-friday-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/next-friday","download_url":"https://codeload.github.com/next-friday/next-friday-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/next-friday%2Fnext-friday-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35822076,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-07-20T02:08:10.276Z","status":"online","status_checked_at":"2026-07-23T02:00:06.683Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","ai-agents","automation","best-practices","claude","claude-code","code-review","developer-tools","github","issue-driven-development","issues","pull-requests","tdd","workflow"],"created_at":"2026-07-24T00:30:43.899Z","updated_at":"2026-07-24T00:30:44.018Z","avatar_url":"https://github.com/next-friday.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Next Friday Skills\n\n[![skills.sh](https://skills.sh/b/next-friday/next-friday-skills)](https://skills.sh/next-friday/next-friday-skills)\n\nAgent skills for shipping through GitHub like a disciplined team. Every change flows **issue → branch → gates → pull request → green CI**.\n\nCoding agents are fast. Fast at building the wrong thing, fast at committing straight to `main`, and fast at declaring \"done\" while CI burns. These skills fix that without taking over your process: your repo's own templates, title rules, commit style, and gates are **discovered, not assumed**, with graceful fallbacks when they don't exist.\n\n## What this does for you\n\nNew to this? In plain terms: you describe what you want in normal language, and your agent handles the disciplined parts. It asks questions to pin down the design, writes that design where your team can see it, builds it in small reviewed steps, opens a pull request, and waits for the automated checks to pass, instead of charging ahead and calling it \"done\" too early. You stay in control: nothing ships without your approval, and you do not need to learn any new commands.\n\n## Installation\n\n### Claude Code\n\nThe Next Friday marketplace provides next-friday and future Next Friday plugins for Claude Code.\n\n- Register the marketplace:\n\n  ```bash\n  /plugin marketplace add next-friday/next-friday-skills\n  ```\n\n- Install the plugin from this marketplace:\n\n  ```bash\n  /plugin install next-friday@skills\n  ```\n\nThen ask your agent to build something. The skills trigger automatically. There are no commands to learn and no change to how you talk to your agent.\n\n### Any agent (skills.sh)\n\nTo install the skills into Claude Code, Cursor, or any agent the [`skills`](https://skills.sh) CLI supports:\n\n```bash\nnpx skills add next-friday/next-friday-skills\n```\n\nThis copies `blueprint`, `implement`, and `rebut` into your agent's skills directory.\n\nNew here? The [Getting Started guide](./docs/getting-started.md) walks through your first issue → pull request → triage cycle end to end.\n\n## Why These Skills Exist\n\nThese skills fix the failure modes that show up again and again when agents ship real software.\n\n### #1: The Agent Built The Wrong Thing\n\n\u003e \"Optimism is an occupational hazard of programming: feedback is the treatment.\"\n\u003e\n\u003e Kent Beck, [Extreme Programming Explained](https://www.amazon.com/Extreme-Programming-Explained-Embrace-Change/dp/0321278658)\n\n**The Problem.** The oldest failure mode in software is misalignment, and agents amplify it, because they start building immediately and optimistically.\n\n**The Fix** is [`blueprint`](./plugins/next-friday/skills/blueprint/SKILL.md): a design interview behind a hard gate. Root context first, then questions batched by dependency level, each with a recommended answer. No code until you approve a written design. The \"too simple to need a design\" excuse is banned; trivial changes just get a proportionally tiny design of 2-4 sentences and one approval.\n\n### #2: The Work Left No Trail\n\n**The Problem.** Agent output that lives in a chat scrollback is gone tomorrow. Your team can't review what they can't see, and next month nobody remembers why the code looks like this.\n\n**The Fix**: [`blueprint`](./plugins/next-friday/skills/blueprint/SKILL.md) records every design where your team already works: a GitHub issue, filled from your repo's issue template. As the design changes, the issue body is rewritten, and GitHub preserves its full edit history. The plan lands on the same issue body. The PR closes it. One thread tells the whole story.\n\n### #3: The PR Doesn't Actually Merge\n\n\u003e \"Done means released.\"\n\u003e\n\u003e Jez Humble \u0026 David Farley, [Continuous Delivery](https://www.amazon.com/Continuous-Delivery-Deployment-Automation-Addison-Wesley/dp/0321601912)\n\n**The Problem.** Local checks passed, but the PR title fails the org's commitlint, no issue is linked, and CI is red. The agent says \"done\"; the repo says otherwise.\n\n**The Fix** is [`implement`](./plugins/next-friday/skills/implement/SKILL.md): branch from the issue, run every gate the repo defines, open the PR from the repo's template with `Closes #N`, then watch CI to green. Red CI means not done. It fixes the cause, never bypasses the gate.\n\n### #4: The AI Reviewer Was Half Right\n\n**The Problem.** AI code reviewers such as CodeRabbit or Gemini Code Assist post a flood of findings: real bugs mixed with false positives that don't know your repo's lint config or conventions. Applying them blindly breaks the build; dismissing them blindly ships the bug.\n\n**The Fix** is [`rebut`](./plugins/next-friday/skills/rebut/SKILL.md): verify every finding against the real code, fix the ones that reproduce, refute the false positives with evidence, and reply in each thread marked as automated triage. Severity labels don't decide, verification does.\n\n### Summary\n\nThese skills condense how disciplined teams actually ship, namely design review, traceable decisions, and gated delivery, into habits your agent applies on every change, scaled to the size of the change.\n\n## The Basic Workflow\n\n1. **blueprint**: Activates before any code is written. Interviews you through the decision tree, proposes 2-3 approaches, presents the design in reviewable sections, then records it as a GitHub issue and writes the implementation plan in the issue body.\n\n2. **implement**: Activates when an issue's design and plan are approved, such as \"implement issue #12\". Branches from the issue, works task by task, runs the full gates, opens a templated PR, watches CI to green, then hands off to `rebut` for the AI-review round.\n\n3. **rebut**: Activates after a push, or whenever an open PR has AI code-review comments. Verifies each finding against the real code, fixes the ones that reproduce, refutes false positives with evidence, and replies in-thread marked as automated triage.\n\nMandatory workflows, not suggestions. The hard gates are part of the skills.\n\n## Reference\n\n- **[blueprint](./plugins/next-friday/skills/blueprint/SKILL.md)**: Design interview → approved design recorded in a GitHub issue → implementation plan. The default flow, with tiered depth (trivial / standard / large).\n- **[implement](./plugins/next-friday/skills/implement/SKILL.md)**: Approved issue → linked branch → gated commits → templated PR → CI watched to green → handoff to rebut.\n- **[rebut](./plugins/next-friday/skills/rebut/SKILL.md)**: Open PR with AI review comments → verified triage → fixes plus evidence-backed refutals → in-thread replies.\n\n## Requirements\n\n- [Claude Code](https://code.claude.com/docs)\n- [`gh` CLI](https://cli.github.com/), authenticated (`gh auth status`)\n- A GitHub-hosted repository\n\n## Updating\n\nUpdates are usually automatic. To update immediately:\n\n```bash\n/plugin update next-friday@skills\n```\n\n## Contributing\n\nSee [CONTRIBUTING.md](./CONTRIBUTING.md). This project follows the [Contributor Covenant Code of Conduct](./CODE_OF_CONDUCT.md).\n\n## License\n\nMIT, see [LICENSE](./LICENSE).\n\n## Community\n\nBuilt by [Next Friday](https://github.com/next-friday).\n\n- **Issues**: \u003chttps://github.com/next-friday/next-friday-skills/issues\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnext-friday%2Fnext-friday-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnext-friday%2Fnext-friday-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnext-friday%2Fnext-friday-skills/lists"}