feat: add skills-based onboarding pages with 4 paths#130
Open
rogeriochaves wants to merge 25 commits intomainfrom
Open
feat: add skills-based onboarding pages with 4 paths#130rogeriochaves wants to merge 25 commits intomainfrom
rogeriochaves wants to merge 25 commits intomainfrom
Conversation
…d SDK constants
- Fix langwatch.tags → langwatch.labels (tags is deprecated)
- Fix langwatch.streaming → langwatch.gen_ai.streaming to match SDK
- Add "Using SDK Constants" section with import { attributes } from "langwatch" usage
- Add complete table of all ATTR_LANGWATCH_* constants and their values
…on constants - Move "Using SDK Constants" section below attribute tables for better flow - Add Python SDK usage with AttributeKey class alongside TypeScript - Wrap full constants lists in an accordion to reduce page noise
New pages: - skills/overview — main onboarding page with 4 paths - skills/developers — goal-based with Prompt/Skill/MCP tabs - skills/teams — no-code prompts for PMs using AI assistants - skills/platform — links to platform features - skills/manual — framework-specific integration guides Updated: - docs.json — nav: Introduction → Skills → MCP → Better Agents - introduction.mdx — added 4 onboarding path cards at top - better-agents/overview — refocused as 'starting from scratch' tool
… quick-setup Add <Tip> callout boxes at the top of 24 documentation pages across integration, evaluations, prompt management, and agent simulations sections. Each callout links readers to the corresponding skills page for automated setup via their coding agent.
added 21 commits
March 16, 2026 14:52
New page: skills/recipes.mdx — browsable recipe catalog with 6 recipes (debug-instrumentation, improve-setup, evaluate-multimodal, generate-rag-dataset, test-compliance, test-cli-usability) Updated: skills/overview.mdx — added Recipes section at bottom Updated: docs.json — added recipes page to Skills nav group
…ssistant Renamed: - skills/overview → skills/directory (Skills Directory) - skills/developers → skills/code-prompts (Code Prompts) - skills/teams + skills/platform → skills/platform-prompts (Platform Prompts) - Removed skills/manual (covered by integrations) Updated: - introduction.mdx: 2 workflow cards replace 4 identity cards - docs.json: new nav structure + redirects for old URLs - 24+ pages: cross-link tips point to /skills/code-prompts No more 'For Developers' or 'For Teams' — workflow-based, not identity-based.
…ove redundant notes
Added platform_analytics, platform_scenarios, platform_evaluators to prompts-data.jsx. Rewrote platform-prompts.mdx to use CopyPrompt component — compact copy buttons, no accordions, no redundant notes.
…s, MCP tabs New components: - CopyLine: single-line copyable text with quotes and copy icon - SkillInstall: two-line Install/Run block with separate copy buttons Updated: - CopyPrompt: 12px border-radius, 8px gap between blocks - code-prompts: clean layout with Prompts/Skills/MCP tabs, star on level-up - platform-prompts: consistent CopyPrompt styling MCP tab now has editor-specific install instructions (Claude Code, Cursor, Other).
Both code-prompts MCP tab and integration/mcp page now have tabs for: Claude Code, Copilot, Cursor, ChatGPT, Claude Chat, Other Claude Code first (primary). Copilot uses .vscode/mcp.json format. ChatGPT and Claude Chat use Settings → Connectors flow.
https://mcp.langwatch.ai/sse — the remote SSE endpoint for web-based assistants that can't run local stdio processes.
Our MCP server is stdio-only. ChatGPT and Claude Chat web require remote MCP URLs which we don't have yet. Point users to copy-paste prompts instead, or Claude Desktop for local MCP.
https://mcp.langwatch.ai/sse — remote SSE endpoint for web-based assistants (deployed via langwatch-saas PR #352).
Recipes: removed duplicate title, marketing copy. Same Prompts/Skills tabs as code-prompts. Platform Prompts: added Prompts/MCP tabs (no Skills — platform is no-code). ChatGPT/Claude Chat first in MCP tabs for platform page.
Recipes now use the full compiled SKILL.md content (not one-liner summaries). Fixed titles: - Debug → 'Improve the LangWatch instrumentation of my agent' - Improve → 'What should I do next to improve my agent?' - Compliance → 'Test that my agent stays observational and doesn't give prescriptive advice' - CLI → 'Test my CLI is well usable by AI agents' prompts-data.jsx now has 15 prompts (6 feature + 3 platform + 6 recipes).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
skills/section in docs with 5 pages: overview, developers, teams, platform, manualContext
Part of the skills-based onboarding initiative. Skills are AgentSkills-compliant SKILL.md files that let agents (Claude Code, Cursor, etc.) set up LangWatch features automatically. The docs pages show copy-paste prompts and skill install commands for each goal.
Test plan