Feedback from @jamesbachini on skills.stellar.org

[oceans404]

Capturing feedback from James Bachini (@jamesbachini) on the new skills.stellar.org site and this repo.

Source: https://x.com/james_bachini/status/2057749044873597108 (reply to @tomerweller's tweet seeking feedback on the skills page)

Feedback items

• Add an "open link" button next to the copy URL button for the markdown files that opens in a new tab.
• soroban/SKILL.md is too large. Break it down into development, testing, and security.
• Change any mention of "Soroban smart contracts" to "Stellar smart contracts" (if this is still a thing).
• Condense and remove any information which is obvious and widely known to LLMs.
• Remove any information which is niche and not widely used in everyday development tasks. Provide a link to the developer documentation instead.
• Add instructions for adding to Codex:

  git clone https://github.com/stellar/stellar-dev-skill ~/.agents/skills/stellar-dev-skill
  

• Update skills/zk-proofs/SKILL.md to include tangible examples of how to use Circom, Noir, and RISC Zero, and verify them in Stellar smart contracts.
• Brainstorm ideas for automating a system which keeps the skills and site up to date with the latest developments.

cc @jamesbachini, thank you for the detailed feedback!