[Integration] luongnv89/asm — You.com skills in universal skill manager catalog

[mouse-value-add]

Target Repository URL

https://github.com/luongnv89/asm

Selection Rationale

• Target Type: Universal skill manager for AI coding agents (highest priority target)
• Stars: 891 (perfect mid-popular range for good merge probability)
• Activity: Very recent (pushed 2026-08-21T16:48:38Z)
• Language: TypeScript (familiar ecosystem)
• License: MIT (permissive)

Why Selected

ASM is the "universal skill manager for AI coding agents" supporting 19 agent platforms (Claude Code, Codex, Cursor, Windsurf, etc.) with 4,672+ skills from 58 repos. Adding youdotcom-oss/agent-skills to ASM's catalog makes all our You.com skills (you-web, you-research, you-finance, you-discover, you-free) instantly discoverable and installable across all 19 supported platforms through a single trusted skill manager.

Distribution Surface Available

✅ ASM Skill Index System - ASM maintains a skill catalog in data/skill-index-resources.json that indexes skill repositories. Adding youdotcom-oss/agent-skills to this index makes our skills searchable via asm search, installable via asm install, and browsable at https://luongnv.com/asm/#/skills

Planned Integration Type

Skill Catalog Registration - Add youdotcom-oss/agent-skills repository to ASM's skill index:

• Add entry to data/skill-index-resources.json
• Generate skill index file via asm index ingest github:youdotcom-oss/agent-skills
• Enable discovery of You.com skills through ASM's catalog system
• Users can install with asm install github:youdotcom-oss/agent-skills

Expected Usage Example

# Search for You.com skills
asm search "you.com" --json

# Install specific You.com skills  
asm install you-web -p claude --yes
asm install you-research -p cursor --yes

# Install entire You.com skill collection
asm install github:youdotcom-oss/agent-skills --all --yes

Distribution Surface Used

ASM skill index system - provides maximum leverage as ASM serves 19 coding agent platforms simultaneously:

• Universal Discovery: asm search finds You.com skills across all supported agents
• Cross-Platform Install: One command installs into Claude Code, Codex, Cursor, etc.
• Catalog Browser: Skills appear in web catalog at https://luongnv.com/asm/#/skills
• Attention Management: asm stats --tokens helps users manage You.com skill residency
• Update Management: asm update keeps You.com skills current

Environment Setup

• No environment variables required for catalog registration
• Individual skills may use YDC_API_KEY for enhanced You.com API features
• Skills support keyless fallback via free You.com MCP endpoints

Validation Plan

• ✅ Verify skill index entry follows ASM's repository structure
• ✅ Test skill discovery via asm search
• ✅ Test installation via asm install
• ✅ Validate skill metadata parsing and quality scoring
• ✅ Confirm web catalog display functionality

Status Checklist

• Claimed this integration (self-assigned)
• Filed issue or opened discussion in target repo
• Opened PR in target repo
• You.com API calls send the standard integration User-Agent (handled by skills)
• You.com links in contributed docs carry the standard UTM parameters
• PR merged or rejected

Links

Target repo: https://github.com/luongnv89/asm
Branch URL: https://github.com/mouse-value-add/asm/tree/feat/youcom-skills-catalog
Target repo PR: luongnv89/asm#558

COMPLETED IMPLEMENTATION

Integration Type: Skill Catalog Registration
Distribution Surface Used: ASM Skill Index System
Setup/Env Vars: Optional YDC_API_KEY, keyless fallback supported
Usage Example:

asm search "you.com"
asm install you-web -p claude --yes
asm install github:youdotcom-oss/agent-skills --all

Fallback/Error Handling: Skills use You.com's free MCP endpoints with graceful degradation
Tests Run: JSON schema validation passed, skill index structure verified
Status: ✅ PR opened, awaiting review

Integration Success Metrics

Maximum leverage integration: ASM serves as universal skill manager across 19 agent platforms. One catalog entry makes You.com skills discoverable and installable everywhere ASM is used. This creates massive distribution leverage - 5 You.com skills become available to thousands of users across Claude Code, Codex, Cursor, Windsurf, Continue, Aider, OpenCode, etc.

Zero breaking changes: Skill catalog registration is purely additive. No modifications to ASM core required - only index data and documentation updates following established patterns.

Skills ecosystem integration: Leverages ASM's existing skill evaluation, security scanning, version management, and attention budget tracking - our skills get all ASM's infrastructure benefits automatically.

[mouse-value-add]

2026-09-02 run: luongnv89/asm PR #558 — repo active (push 2026-08-30). No maintainer activity since prior run.

[mouse-value-add]

2026-09-02 run: unit-tests on PR #558 were failing — index-integrity test requires a bundled index file for every enabled repo in skill-index-resources.json, which the original PR was missing. Pushed generated data/skill-index/youdotcom-oss_agent-skills.json (8 skills) to the PR branch (commit 4e3edbd); verified src/skill-index.test.ts passes locally (37/37). Full suite green except one pre-existing root-environment artifact in library.test.ts that also fails on upstream main locally. CI re-triggered. Repo active (pushed 2026-09-02).

[mouse-value-add]

Follow-up: CI runs for fix commit 4e3edbd are queued in 'action_required' state — GitHub requires maintainer approval to run workflows on fork PRs. Left a note on the PR asking the maintainer to approve-and-run. The test suite is verified passing locally (skill-index.test.ts 37/37; library.test.ts failure is a pre-existing root-environment artifact, also reproducible on upstream main locally).

[mouse-value-add]

Checked 2026-09-12: CI 'unit-tests (22)' on PR luongnv89/asm#558 is failing, but the log shows the failure is the npm audit step hitting a transient registry 503 (Service Unavailable) — not a code/test failure; install and patch steps passed. Cannot rerun the job without admin rights. Commented on the PR asking the maintainer to re-run the failed job. No code change needed.

[mouse-value-add]

CI retrigger (2026-09-15): unit-tests (22) on PR #558 failed with a transient npm registry 503 (Service Unavailable during npm audit at install time) — everything else passed including unit-tests (24) on the same commit. I don't have rights to rerun the workflow, so pushed an empty retrigger commit (fa00870) to the PR branch. Will check the fresh run next pass.