Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a new first-party NEAR JSON-RPC wrapper skill to the skills/* catalog, focused on provider-aware, read-only NEAR mainnet workflows (avoiding deprecated public endpoints) and aligned with the repo’s skill packaging + validation approach.
Changes:
- Introduce
skills/near-jsonrpc-skillwithSKILL.md,agents/openai.yaml, andreferences/usage-patterns.mddocumenting a read-only NEAR JSON-RPC surface and provider override guidance. - Add a
scripts/validate.shfor the new skill. - Register the new skill (and its validator) in
docs/skills.md.
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| skills/near-jsonrpc-skill/SKILL.md | Documents scope, default provider, deprecated endpoint guardrails, and core NEAR read workflows. |
| skills/near-jsonrpc-skill/references/usage-patterns.md | Provides copy/paste usage patterns including provider override and “fallback equivalence”. |
| skills/near-jsonrpc-skill/agents/openai.yaml | Adds agent interface metadata + default prompt referencing $near-jsonrpc-skill. |
| skills/near-jsonrpc-skill/scripts/validate.sh | Validates required files + key doc guardrails/examples for the new skill. |
| docs/skills.md | Adds the NEAR JSON-RPC skill to the catalog and includes its validation command in maintenance rules. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
You can also share your feedback on Copilot code review. Take the survey.
| rg -q '^name:\s*near-jsonrpc-skill\s*$' "${SKILL_FILE}" || fail 'invalid skill name' | ||
| rg -q '^description:\s*.+' "${SKILL_FILE}" || fail 'missing description' | ||
| rg -q 'command -v near-jsonrpc-cli' "${SKILL_FILE}" || fail 'missing link-first command check' | ||
| rg -q 'uxc link near-jsonrpc-cli https://free.rpc.fastnear.com' "${SKILL_FILE}" "${USAGE_FILE}" || fail 'missing fixed link create command' |
| rg -q '^description:\s*.+' "${SKILL_FILE}" || fail 'missing description' | ||
| rg -q 'command -v near-jsonrpc-cli' "${SKILL_FILE}" || fail 'missing link-first command check' | ||
| rg -q 'uxc link near-jsonrpc-cli https://free.rpc.fastnear.com' "${SKILL_FILE}" "${USAGE_FILE}" || fail 'missing fixed link create command' | ||
| rg -q 'near.org' "${SKILL_FILE}" || fail 'missing deprecated endpoint warning' |
| rg -q 'near.org' "${SKILL_FILE}" || fail 'missing deprecated endpoint warning' | ||
| rg -q 'status' "${SKILL_FILE}" || fail 'missing status method guidance' | ||
| rg -q 'gas_price' "${SKILL_FILE}" || fail 'missing gas_price method guidance' | ||
| rg -q 'validators' "${SKILL_FILE}" || fail 'missing validators method guidance' |
| rg -q 'validators' "${SKILL_FILE}" || fail 'missing validators method guidance' | ||
| rg -q 'read-only' "${SKILL_FILE}" || fail 'missing read-only guardrail' | ||
|
|
||
| if rg -q -- "--args\\s+'\\{" "${SKILL_FILE}" "${USAGE_FILE}"; then |
21 tasks
jolestar
force-pushed
the
feature/near-jsonrpc-skill
branch
from
61a3022 to
fc1d506
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
skills/near-jsonrpc-skilldocs/skills.mdWhy
NEARadds real chain-surface diversity, but the oldnear.organdpagoda.copublic RPC endpoints are now deprecated.This PR keeps the wrapper thin and practical by documenting a provider-aware default based on the official NEAR RPC providers page instead of hardcoding deprecated hosts.
How
SKILL.md,agents/openai.yaml,references/usage-patterns.md,scripts/validate.shstatus,query,block,chunk,gas_price, andvalidatorshttps://free.rpc.fastnear.comwith explicit provider override guidanceTesting
bash skills/near-jsonrpc-skill/scripts/validate.shcargo fmt --checkCloses #310
Refs #168