Skip to content

feat: add optional you.com search integration - #558

Open
mouse-value-add wants to merge 2 commits into
luongnv89:mainfrom
mouse-value-add:feat/youcom-skills-catalog
Open

feat: add optional you.com search integration#558
mouse-value-add wants to merge 2 commits into
luongnv89:mainfrom
mouse-value-add:feat/youcom-skills-catalog

Conversation

@mouse-value-add

Copy link
Copy Markdown

What this PR adds

Adds the youdotcom-oss/agent-skills repository to ASM's skill catalog, making You.com's web search and research capabilities available across all 19 supported agent platforms.

Skills included

  • you-web: Current web search, URL content extraction, cited synthesis
  • you-research: Deep research routing, Research API scripts, MCP fallback
  • you-finance: Finance research routing and market data access
  • you-discover: Integration planning and resource discovery
  • you-free: Keyless basic web search for quick testing

Why this fits ASM

ASM is designed as a universal skill manager across coding agent platforms. You.com skills enhance agents with current web search capabilities - something many coding tasks benefit from when researching libraries, debugging issues, or finding current documentation.

The integration follows ASM's established pattern for skill repository registration rather than custom code.

Usage after merge

# Discover You.com skills
asm search "you.com"
asm search "web search"

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

# Install all You.com skills at once  
asm install github:youdotcom-oss/agent-skills --all --yes

Distribution benefit

This leverages ASM's position as a universal skill manager - one catalog entry makes You.com skills discoverable and installable across Claude Code, Codex, Cursor, Windsurf, Continue, Aider, OpenCode, Zed, and 11 other supported platforms.

Environment setup

  • Skills work keyless via You.com's free MCP endpoints
  • Optional YDC_API_KEY environment variable enables enhanced features
  • No breaking changes to ASM - purely additive catalog registration

Changes made

  • ✅ Added youdotcom-oss/agent-skills entry to data/skill-index-resources.json
  • ✅ Updated README skill collections table with You.com entry
  • ✅ Added installation example following existing patterns
  • ✅ Verified JSON schema remains valid

Validation

  • JSON validates successfully
  • Follows ASM's skill repository registration patterns
  • Installation examples match existing style
  • No modifications to ASM core functionality required

The skills themselves use You.com's MCP server (https://api.you.com/mcp?profile=free) and web search APIs, providing agents with current web search capabilities while maintaining ASM's lightweight catalog-only integration approach.

Tracking issue: youdotcom-oss/integration-tracking#213

Adds youdotcom-oss/agent-skills to ASM's skill index, making You.com's
web search, research, and discovery skills available across all 19
supported agent platforms (Claude Code, Codex, Cursor, Windsurf, etc).

Skills included:
- you-web: Current web search, URL extraction, cited synthesis
- you-research: Deep research routing and Research API scripts
- you-finance: Finance research and market data
- you-discover: Integration discovery and resource mapping
- you-free: Keyless basic web search

Users can now discover and install You.com skills via:
- asm search "you.com" or "web search"
- asm install you-web -p claude --yes
- asm install github:youdotcom-oss/agent-skills --all

Changes:
- Add youdotcom-oss/agent-skills to data/skill-index-resources.json
- Update README skill collections table
- Add installation example for You.com skills

Follows ASM's established patterns for skill repository integration.
The index-integrity test requires every enabled repo in
data/skill-index-resources.json to have a matching bundled
index file. Adds the generated index (8 skills) for
youdotcom-oss/agent-skills so unit-tests pass.
@mouse-value-add

Copy link
Copy Markdown
Author

CI caught a real gap on my side — the index-integrity test requires every enabled repo in skill-index-resources.json to have a matching bundled index file, and I'd only added the resources entry. I've pushed the generated data/skill-index/youdotcom-oss_agent-skills.json (8 skills) so the unit-tests should go green now.

@mouse-value-add

Copy link
Copy Markdown
Author

Heads up: the workflow runs for the new commit (4e3edbd) are sitting in 'action_required' — GitHub needs you to approve them for this fork PR. Once approved, the unit-tests should pass with the bundled index file in place. I verified src/skill-index.test.ts (37/37) locally on this branch.

@mouse-value-add

Copy link
Copy Markdown
Author

The failed unit-tests (22) check is not a code failure — the job log shows it exited at the npm audit step after the npm registry returned a transient 503 (npm warn audit 503 Service Unavailable); the actual install and patch steps completed fine before it. Everything up to that point passed.

Could you re-run the failed job on your side when you get a chance? Happy to push an empty retrigger commit if that's easier.

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.

1 participant