Skip to content

refactor: restructure skills, enrich content, add CI checks - #17

Merged
Agilulfo1820 merged 12 commits into
mainfrom
refactor/split-skills-core-frontend-kit
Mar 12, 2026
Merged

Agilulfo1820 merged 12 commits into
mainfrom
refactor/split-skills-core-frontend-kit

Conversation

@Agilulfo1820

@Agilulfo1820 Agilulfo1820 commented Mar 11, 2026

Copy link
Copy Markdown
Member

Summary

  • Split vechain-dev monolith into focused skills: vechain-core, vechain-kit, and frontend
  • Enriched vechain-kit with official docs content (hooks, theming, components, social login, troubleshooting), then split the 43KB reference into 5 focused files (kit-setup.md, kit-hooks.md, kit-components.md, kit-social-login.md, kit-theming.md)
  • Enriched vebetterdao with comprehensive contracts reference covering all 19 smart contracts (including X2EarnApps V8 endorsement and VeBetterPassport sybil resistance)
  • Added CI workflows — split monolithic ci.yml into 4 independent parallel workflows:
    • Lint — markdown lint + plugin structure validation
    • Verify References — broken links and stale skill names, with PR comment on failure
    • Size Report — PR comment with skill size metrics and large-file flags
    • Security Audit — scans for secrets, prompt injection, dangerous code, hidden Unicode, suspicious URLs; HIGH findings block merge
  • Renamed plugin from vechain-dev to vechain-ai in marketplace/plugin manifests

Test plan

  • All 4 CI workflows pass independently
  • Security audit reports no HIGH findings
  • npm run validate passes
  • npm run verify-refs passes
  • npm run security-audit passes
  • Size report comment appears on PR
  • Skill content is accurate against official VeChain docs

🤖 Generated with Claude Code

Agilulfo1820 and others added 3 commits March 11, 2026 17:46
…end skills

- Rename vechain-dev → vechain-core (SDK, fee delegation, multi-clause, dual-token)
- Narrow vechain-kit to package-specific scope (hooks, components, setup, dapp-kit)
- Create frontend skill for generic patterns (React Query, Turborepo, state management, Chakra UI, i18n, transaction UX)
- Move frontend.md reference from vechain-kit to frontend skill
- Fix all broken cross-skill references in reference files
- Update plugin.json and marketplace.json registries
- Update companion skill references in create-vechain-dapp and vechain-react-native-dev

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Add verify-references.cjs to check broken file links and stale skill
  name references across all skill markdown files
- Update CI workflow to run verification on PRs, post a comment with
  errors and an AI fix prompt on failure, clean up comment on success
- Fix broken fee-delegation.md link in smart-contract-development skill

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Agilulfo1820 and others added 3 commits March 11, 2026 17:59
The plugin name is what shows in "Installed plugins". Having it as
"vechain-dev" collided with the old skill name and caused duplicate
identical entries when installing different marketplace skills.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add VET domain hooks (text records, resolution, mutations, subdomains),
network utility hooks, legal documents hook, NFT metadata URI hook,
modal hooks catalog, theming API updates (bottom sheet, glass effects,
tertiary button, font scoping), WalletButton customization, and
troubleshooting entries (BigInt serialization, Privy popup blocking,
CSS layers, testing mocks).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Post a PR comment with skill size metrics (SKILL.md, references, totals)
and flag large files that consume excessive context window. Reviewers can
see at a glance which skills are growing and where to split references.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Mar 11, 2026

Copy link
Copy Markdown

Skill Size Report

Skill SKILL.md (always loaded) Ref files (on demand) Total est. tokens Alerts
vechain-kit ~1.4K tok 7 files, ~13.0K tok ~14.4K tok
smart-contract-development ~1.1K tok 5 files, ~11.9K tok ~13.0K tok
vechain-core ~1.2K tok 4 files, ~8.7K tok ~9.9K tok
vebetterdao ~839 tok 3 files, ~7.9K tok ~8.7K tok
vechain-react-native-dev ~1.5K tok 3 files, ~6.7K tok ~8.2K tok
create-vechain-dapp ~1.3K tok 3 files, ~6.3K tok ~7.6K tok
stargate ~736 tok 2 files, ~5.0K tok ~5.7K tok
frontend ~1.1K tok 1 files, ~3.0K tok ~4.0K tok
auto-voting-relayers ~2.8K tok 0 files, ~0 tok ~2.8K tok ⚠️ SKILL.md ~2.8K tok (always in context)
translate ~1.2K tok 0 files, ~0 tok ~1.2K tok
grill-me ~418 tok 0 files, ~0 tok ~418 tok
TOTAL ~76.0K tok
Large reference files (>5.0K tok)
File Est. tokens
None

How to read this: SKILL.md is always loaded into the context window. Reference files are loaded on demand when the topic matches. Token counts are estimates (~4 chars/token). Consider splitting reference files over ~5.0K tokens.

Agilulfo1820 and others added 3 commits March 11, 2026 18:28
Replace the 43KB monolith with topic-specific files so Claude only loads
the relevant reference per question:
- kit-setup.md: installation, provider, CSS, env vars, pitfalls
- kit-hooks.md: all hooks (wallet, transactions, domains, NFTs, etc.)
- kit-components.md: WalletButton, TransactionModal, modal hooks
- kit-social-login.md: smart accounts, Privy, fee delegation, DIY
- kit-theming.md: theme config, Chakra compat, webpack fallbacks

Update SKILL.md reference table and fix cross-references in dappkit
and fee-delegation files.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Cover all 19 contracts with key functions, roles, and relationships.
Includes X2EarnApps V8 flexible endorsement and VeBetterPassport
sybil resistance systems scraped from official docs.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Replace monolithic ci.yml with 4 independent workflows that run in
parallel: lint, verify-references, size-report, and security-audit.

The new security audit scans skill files for secrets, prompt injection,
dangerous code patterns, hidden Unicode characters, and suspicious URLs.
HIGH severity findings block merge.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@Agilulfo1820 Agilulfo1820 changed the title refactor: split skills into vechain-core, vechain-kit, and frontend refactor: restructure skills, enrich content, add CI checks Mar 11, 2026
Comment thread scripts/skill-security-audit.cjs Fixed
Comment thread scripts/skill-security-audit.cjs Fixed
Agilulfo1820 and others added 3 commits March 11, 2026 18:51
…ng or encoding

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
Cover Stargate, StargateNFT, and ProtocolStaker contracts with key
functions, roles, types, events, errors, and integration details.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Replace KB metrics with estimated token counts (~4 chars/token) for
better context window intuition. Rename "Flags" to "Alerts" with
explanations. Make CI trigger explicit for PR push updates.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@Agilulfo1820
Agilulfo1820 merged commit 9f94f2c into main Mar 12, 2026
7 checks passed
@Agilulfo1820
Agilulfo1820 deleted the refactor/split-skills-core-frontend-kit branch March 12, 2026 08:42
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.

3 participants