Skip to content

feat: bundle http-client consumer skill - #7

Merged
coisa merged 3 commits into
mainfrom
codex/bundled-consumer-skill
Oct 21, 2026
Merged

coisa merged 3 commits into
mainfrom
codex/bundled-consumer-skill

Conversation

@coisa

@coisa coisa commented Oct 20, 2026 •

Copy link
Copy Markdown
Contributor

Applications need a complete integration procedure for fast-forward/http-client. Bundle resources/skills/fast-forward-http-client with a supported ^1.2 contract, MIT license, executable examples and optional project/global installation guidance. Declare Composer discovery metadata and suggest llm/skills without adding a runtime installer; link the canonical source from README and the root AGENTS contract.

The application supplies concrete PSR-17 factories. Require Nyholm only for this repository's development example/tests; the consumer skill explicitly installs it for its mock-backed integration. The runtime provider and runtime requirements stay intact.

Validation:

  • Official skills-ref 0.1.0 at agentskills/agentskills@69ef37e validates the finished package.
  • Strict Composer metadata and committed Changelog contribution checks pass. Changelog was checked through the existing CLI source at e75a9be, using --since=origin/main --source=tags.
  • Git archive preserves the entire skill payload. Disposable Composer consumers install the candidate archive, and llm/skills 1.15.0 automatically copies only the narrowly trusted donor. Every payload file is compared byte for byte.
  • The complete PHPUnit suite passes on PHP 8.5.11: 3 tests / 7 assertions. Inline first-use instructions and packaged examples run on PHP 8.3.35 in a disposable CLI environment; Fork uses PCNTL/POSIX.
  • The broader DevTools pipeline has been exercised; this draft retains any remaining inherited tooling/style diagnostics for review rather than claiming a complete green gate. Final current checks are reported on the PR.

The declared minimum describes the release introducing the skill. Disposable path repositories label the exact candidate source with that version solely for validation; no release/tag is claimed or created. New integration/docs text is original, guided by source/tests; LICENSE uses the maintainer's established MIT terms. Native host discovery, session activation and fresh-model task performance remain unverified. No global host skills are installed. No merge or release is performed.

Additional lifecycle checks: automatic synchronization with --no-scripts, explicit update, auto-sync:false, installed-plugin suppression with --no-plugins, same-path overwrite, extra/unrelated-file retention and donor/plugin removal were exercised in disposable consumers. Guarded project and isolated-global copies refuse existing targets; update backup and rollback were tested. The pinned Skills CLI project add/list route works, but its removal can leave the canonical .agents/skills copy; the installation guide now documents that observed limitation. Final archive/installed/manager copies match the finished payload byte for byte.

@coderabbitai

coderabbitai Bot commented Oct 20, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 46 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

Learn how review limits work.

Review configuration:

⚙️ Run configuration
  • Configuration used: Organization UI
  • Review profile: ASSERTIVE
  • Plan: Advanced
  • Run ID: 3fb5284c-4e85-4908-9476-aed8aad023b2
📥 Commits

Reviewing files that changed from the base of the PR and between a4a6a7f and afaef49.

📒 Files selected for processing: 9
  • .changelog/bundled-consumer-skill.md
  • AGENTS.md
  • README.md
  • composer.json
  • resources/skills/fast-forward-http-client/LICENSE
  • resources/skills/fast-forward-http-client/SKILL.md
  • resources/skills/fast-forward-http-client/examples/integration.php
  • resources/skills/fast-forward-http-client/references/installation.md
  • tests/ConsumerSkillTest.php
📝 Summary

Summary by CodeRabbit

  • New Features

    • Added a bundled fast-forward-http-client consumer skill with PHP integration guidance, configuration details, and executable examples.
    • Included a no-network example demonstrating successful JSON responses and transport-failure handling.
  • Documentation

    • Added installation and synchronization instructions for Composer and Skills CLI workflows.
    • Documented version requirements, discovery settings, verification steps, and safe cleanup practices.
    • Added licensing information for the bundled skill.
  • Chores

    • Added Composer metadata to support bundled skill discovery and optional tooling integration.

The repository now bundles a fast-forward-http-client consumer skill with integration guidance, a runnable example, installation instructions, Composer discovery metadata, and a PHPUnit integration test.

Changes: Consumer Skill Bundle

Layer / File(s) Summary
Bundle metadata and distribution
composer.json, .changelog/bundled-consumer-skill.md, resources/skills/fast-forward-http-client/LICENSE
Composer now declares the skill source, an optional llm/skills suggestion, and a development dependency. The changelog records the addition, and the bundle includes license terms.
Integration guide and executable example
resources/skills/fast-forward-http-client/SKILL.md, resources/skills/fast-forward-http-client/examples/integration.php, tests/ConsumerSkillTest.php, AGENTS.md
The skill guide documents the supported package version and integration behavior. The example checks mocked success and transport failure. The PHPUnit test runs the example, and repository guidance specifies maintenance and validation requirements.
Installation and synchronization guidance
README.md, resources/skills/fast-forward-http-client/references/installation.md
The documentation describes Composer discovery, guarded manual copying, and the optional Skills CLI workflow, including synchronization and rollback guidance.

Priority: ⬇️ Low

Estimated code review effort: 2 (Simple) | ~15 minutes

Change: Feature

Merge Risk: ⚪ Minimal · up to a4a6a

No established merge-blocking defect remains in the bundled skill; it is mergeable after normal checks.

Pre-merge checks: Passed 5
Check name Status Explanation
Title check Passed The title clearly and concisely describes the primary change: bundling the HTTP client consumer skill.
Description check Passed The description directly explains the bundled consumer skill, Composer metadata, installation guidance, validation, and scope of the changes.
Docstring Coverage Passed Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 1 functions across 2 files. (7 skipped: 7 …
Linked Issues check Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check Passed Check skipped because no linked issues were found for this pull request.
Full details: Docstring Coverage

Explanation

Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 1 functions across 2 files. (7 skipped: 7 unsupported.)

✨ Finishing Touches: 💡 1
⚔️ Resolve merge conflicts: 💡
  • Resolve merge conflict in branch codex/bundled-consumer-skill
📝 Generate docstrings
  • Commit to this branch
  • Create a new PR
🧪 Generate unit tests (beta)
  • Commit to this branch
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

A rabbit found a skill to share,
With mocked replies and tests to spare.
It checked the code, then hopped along,
The success marker proved it strong.
“Install by choice,” the rabbit said,
Then tucked the guide beside its bed.

Comment @coderabbitai help to get the list of available commands.

@coisa
coisa marked this pull request as ready for review October 21, 2026 01:10
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 21, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-21T01:25:36.208451Z afaef49 New commits
🔒 Security Review ✅ Completed 2026-10-21T01:27:39.780007Z afaef49 New commits
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔇 Additional comments: 5
composer.json: 1

25-29: LGTM!

Also applies to: 61-63

resources/skills/fast-forward-http-client/LICENSE: 1

1-20: LGTM!

README.md: 1

121-129: LGTM!

.changelog/bundled-consumer-skill.md-6-6: 1

6-6: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

⚠️ Unverified finding
Verification ran but could not confirm this finding. It is shown for review, not as a verified issue.

Add a top-level heading to the changelog fragment.

markdownlint-cli2 reports MD041 because the first body line is prose. Add a level-one heading after the front matter, or configure .changelog fragments to exempt this rule if the format intentionally omits headings.

Source: Linters/SAST tools

resources/skills/fast-forward-http-client/references/installation.md-165-165: 1

165-165: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

⚠️ Unverified finding
Verification ran but could not confirm this finding. It is shown for review, not as a verified issue.

Use “afterward” for American English.

Replace “afterwards” with “afterward” to match the documented locale style.

Source: Linters/SAST tools


ℹ️ Review info
⚙️ Run configuration
  • Configuration used: Organization UI
  • Review profile: ASSERTIVE
  • Plan: Advanced
  • Run ID: 1ebf5ce7-db05-4b65-8712-755b36a44f2f
📥 Commits

Reviewing files that changed from the base of the PR and between 02115ed and a4a6a7f.

📒 Files selected for processing: 9
  • .changelog/bundled-consumer-skill.md
  • AGENTS.md
  • README.md
  • composer.json
  • resources/skills/fast-forward-http-client/LICENSE
  • resources/skills/fast-forward-http-client/SKILL.md
  • resources/skills/fast-forward-http-client/examples/integration.php
  • resources/skills/fast-forward-http-client/references/installation.md
  • tests/ConsumerSkillTest.php

Included review availability: This review used your included allowance. Your plan provides up to 1 included review per hour; 0 remain after this review.

@github-actions

Copy link
Copy Markdown
Contributor

Changelog

✅ Contribution check passed.

Head: afaef4993e12be3e457513c4a766a6b34e5e7549

Base: 907f48daab8599859b50d4c971acda55a6baff8b

Contribution: 1 new valid fragment(s). Policy: ordinary.

  • bundled-consumer-skill.md — added, minor

    Bundle the fast-forward-http-client consumer skill with executable examples, optional installation guidance and Composer discovery metadata.

@coisa
coisa merged commit b69d079 into main Oct 21, 2026
35 checks passed
@coisa
coisa deleted the codex/bundled-consumer-skill branch October 21, 2026 01:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant