Skip to content

Add agent skills for AI coding#2804

Open
yihao03 wants to merge 13 commits intoMarkBind:masterfrom
yihao03:feat/experiment-with-skills
Open

Add agent skills for AI coding#2804
yihao03 wants to merge 13 commits intoMarkBind:masterfrom
yihao03:feat/experiment-with-skills

Conversation

@yihao03
Copy link
Contributor

@yihao03 yihao03 commented Jan 26, 2026

used opencode to read devGuide and generated relevant skills

What is the purpose of this pull request?

  • Documentation update
  • Bug fix
  • Feature addition or enhancement
  • Code maintenance
  • DevOps
  • Improve developer experience
  • Others, please explain:

Overview of changes:
This PR serves as part of the effort to develop an AI workflow for development.

We opted to use the open source SKILL.md standard as it is provider agnostic and has good community support.
Therefore we could adopt mainstream and popular workflows developed by others without being restricted to a specific provider (e.g. ClaudeCode).

Useful references in creating skills:

Anything you'd like to highlight/discuss:

Testing instructions:
Use AI Coding tools like OpenCode/ClaudeCode to start writing code. Check if the skills are being picked up
correctly and performs as desired

Proposed commit message: (wrap lines at 72 characters)
Add Agent Skills.


Checklist: ☑️

  • Updated the documentation for feature additions and enhancements
  • Added tests for bug fixes or features
  • Linked all related issues
  • No unrelated changes

Reviewer checklist:

Indicate the SEMVER impact of the PR:

  • Major (when you make incompatible API changes)
  • Minor (when you add functionality in a backward compatible manner)
  • Patch (when you make backward compatible bug fixes)

At the end of the review, please label the PR with the appropriate label: r.Major, r.Minor, r.Patch.

Breaking change release note preparation (if applicable):

  • To be included in the release note for any feature that is made obsolete/breaking

Give a brief explanation note about:

  • what was the old feature that was made obsolete
  • any replacement feature (if any), and
  • how the author should modify his website to migrate from the old feature to the replacement feature (if possible).

used opencode to read devGuide and generated relevant skills
@codecov
Copy link

codecov bot commented Jan 26, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 72.20%. Comparing base (2f6cb37) to head (5f590fd).

Additional details and impacted files
@@           Coverage Diff           @@
##           master    #2804   +/-   ##
=======================================
  Coverage   72.20%   72.20%           
=======================================
  Files         134      134           
  Lines        7454     7454           
  Branches     1528     1553   +25     
=======================================
  Hits         5382     5382           
+ Misses       2026     1944   -82     
- Partials       46      128   +82     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@yihao03 yihao03 marked this pull request as ready for review February 1, 2026 14:50
@gerteck
Copy link
Member

gerteck commented Feb 2, 2026

The references would definitely be useful for an AI agent to immediately have a good grasp of the codebase.

However, I am worried about the maintainability of the references.

  • Would having these references (e.g. referencing specific Node versions, method names, file names and directory structures) cause a maintainence overhead when we do refactoring?
  • What kind of measures do we have to make sure that the references do not drift from the features?

How do we find the balance of keeping a abstract and high level explanation of the design in the references enough to not have to add too much maintainability burden, but have it detailed enough to justify the token count and usefulness.

This is on top of the current developer documentation that has to be updated as well.

wdyt?

@yihao03
Copy link
Contributor Author

yihao03 commented Feb 3, 2026

Would it be useful if we created a subagent #2822 that updates the skills accordingly when changes are made to the devGuide? the solution to AI is... more AI...

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.

2 participants