鱼皮AI导航
鱼皮AI导航
  • 主页
  • 社区
  • AI工具
  • AI知识库
  • AI提示词
  • MCP
  • Skills
  • AI学习资源
  • AI资讯
  • GitHub开源
登录/注册

resource-curator

系统维护 JavaScript 概念文档的外部学习资源,自动检测并修复失效链接,筛选符合时效性与技术准确性的优质内容,确保教程、视频及参考文档的多样性与教学价值,提升学习者获取知识的效率与体验。

文档处理
访问 GitHub
文档Skills.MD
name
resource-curator
description
Find, evaluate, and maintain high-quality external resources for JavaScript concept documentation, including auditing for broken and outdated links

Skill: Resource Curator for Concept Pages

Use this skill to find, evaluate, add, and maintain high-quality external resources (articles, videos, courses) for concept documentation pages. This includes auditing existing resources for broken links and outdated content.

When to Use

  • Adding resources to a new concept page
  • Refreshing resources on existing pages
  • Auditing for broken or outdated links
  • Reviewing community-contributed resources
  • Periodic link maintenance

Resource Curation Methodology

Follow these five phases for comprehensive resource curation.

Phase 1: Audit Existing Resources

Before adding new resources, audit what's already there:

  1. Check link accessibility — Does each link return 200?
  2. Verify content accuracy — Is the content still correct?
  3. Check publication dates — Is it too old for the topic?
  4. Identify outdated content — Does it use old syntax/patterns?
  5. Review descriptions — Are they specific or generic?

Phase 2: Identify Resource Gaps

Compare current resources against targets:

SectionTarget CountIcon
Reference2-4 MDN linksbook
Articles4-6 articlesnewspaper
Videos3-4 videosvideo
Courses1-3 (optional)graduation-cap
Books1-2 (optional)book

Ask:

  • Are there enough resources for beginners AND advanced learners?
  • Is there visual content (diagrams, animations)?
  • Are official references (MDN) included?
  • Is there diversity in teaching styles?

Phase 3: Find New Resources

Search trusted sources using targeted queries:

For Articles:

▼
text
复制代码
[concept] javascript tutorial site:javascript.info [concept] javascript explained site:freecodecamp.org [concept] javascript site:dev.to [concept] javascript deep dive site:2ality.com [concept] javascript guide site:css-tricks.com

For Videos:

▼
text
复制代码
YouTube: [concept] javascript explained YouTube: [concept] javascript tutorial YouTube: jsconf [concept] YouTube: [concept] javascript fireship YouTube: [concept] javascript web dev simplified

For MDN:

▼
text
复制代码
[concept] site:developer.mozilla.org [API name] MDN

Phase 4: Write Descriptions

Every resource needs a specific, valuable description:

Formula:

▼
text
复制代码
Sentence 1: What makes this resource unique OR what it specifically covers Sentence 2: Why reader should click (what they'll gain, who it's best for)

Phase 5: Format and Organize

  • Use correct Card syntax with proper icons
  • Order resources logically (foundational first, advanced later)
  • Ensure consistent formatting

Trusted Sources

Reference Sources (Priority Order)

PrioritySourceURLBest For
1MDN Web Docsdeveloper.mozilla.orgAPI docs, guides, compatibility
2ECMAScript Spectc39.es/ecma262Authoritative behavior
3Node.js Docsnodejs.org/docsNode-specific APIs
4Web.devweb.devPerformance, best practices
5Can I Usecaniuse.comBrowser compatibility

Article Sources (Priority Order)

PrioritySourceWhy Trusted
1javascript.infoComprehensive, exercises, well-maintained
2MDN GuidesOfficial, accurate, regularly updated
3freeCodeCampBeginner-friendly, practical
42ality (Dr. Axel)Deep technical dives, spec-focused
5CSS-TricksDOM, visual topics, well-written
6dev.to (Lydia Hallie)Visual explanations, animations
7LogRocket BlogPractical tutorials, real-world
8Smashing MagazineIn-depth, well-researched
9Digital OceanClear tutorials, examples
10Kent C. DoddsTesting, React, best practices

Video Creators (Priority Order)

PriorityCreatorStyleBest For
1FireshipFast, modern, entertainingQuick overviews, modern JS
2Web Dev SimplifiedClear, beginner-friendlyBeginners, fundamentals
3Fun Fun FunctionDeep-dives, personalityUnderstanding "why"
4Traversy MediaComprehensive crash coursesFull topic coverage
5JSConf/dotJSExpert conference talksAdvanced, in-depth
6AcademindThorough explanationsComplete understanding
7The Coding TrainCreative, visualVisual learners
8Wes BosPractical, real-worldApplied learning
9The Net NinjaStep-by-step tutorialsFollowing along
10Programming with MoshProfessional, clearCareer-focused

Course Sources

SourceTypeNotes
javascript.infoFreeComprehensive, exercises
PiccalilliFreeWell-written, modern
freeCodeCampFreeProject-based
Frontend MastersPaidExpert instructors
Egghead.ioPaidShort, focused lessons
Udemy (top-rated)PaidCheck reviews carefully
CodecademyFreemiumInteractive

Quality Criteria

Must Have (Required)

  • Link works — Returns 200 (not 404, 301, 5xx)
  • JavaScript-focused — Not primarily about C#, Python, Java, etc.
  • Technically accurate — No factual errors or anti-patterns
  • Accessible — Free or has meaningful free preview

Should Have (Preferred)

  • Recent enough — See publication date guidelines below
  • Reputable source — From trusted sources list or well-known creator
  • Unique perspective — Not duplicate of existing resources
  • Appropriate depth — Matches concept complexity
  • Good engagement — Positive comments, high views (for videos)

Red Flags (Reject)

Red FlagWhy It Matters
Uses var everywhereOutdated for ES6+ topics
Teaches anti-patternsHarmful to learners
Primarily other languagesWrong focus
Hard paywall (no preview)Inaccessible
Pre-2015 for modern topicsLikely outdated
Low quality commentsOften indicates issues
Factual errorsSpreads misinformation
Clickbait title, thin contentWastes reader time

Publication Date Guidelines

Topic CategoryMinimum YearReasoning
ES6+ Features2015+ES6 released June 2015
Promises2015+Native Promises in ES6
async/await2017+ES2017 feature
ES Modules2018+Stable browser support
Optional chaining (?.)2020+ES2020 feature
Nullish coalescing (??)2020+ES2020 feature
Top-level await2022+ES2022 feature
Fundamentals (closures, scope, this)AnyCore concepts don't change
DOM manipulation2018+Modern APIs preferred
Fetch API2017+Widespread support

Rule of thumb: For time-sensitive topics, prefer content from the last 3-5 years. For fundamentals, older classic content is often excellent.


Description Writing Guide

The Formula

▼
text
复制代码
Sentence 1: What makes this resource unique OR what it specifically covers Sentence 2: Why reader should click (what they'll gain, who it's best for)

Good Examples

▼
markdown
复制代码
<Card title="JavaScript Visualized: Promises & Async/Await — Lydia Hallie" icon="newspaper" href="https://dev.to/lydiahallie/javascript-visualized-promises-async-await-5gke"> Animated GIFs showing the call stack, microtask queue, and event loop in action. The visuals make Promise execution order finally click for visual learners. </Card> <Card title="What the heck is the event loop anyway? — Philip Roberts" icon="video" href="https://www.youtube.com/watch?v=8aGhZQkoFbQ"> The legendary JSConf talk that made the event loop click for millions of developers. Philip Roberts' live visualizations are the gold standard — a must-watch. </Card> <Card title="You Don't Know JS: Scope & Closures — Kyle Simpson" icon="book" href="https://github.com/getify/You-Dont-Know-JS/blob/2nd-ed/scope-closures/README.md"> Kyle Simpson's deep dive into JavaScript's scope mechanics and closure behavior. Goes beyond the basics into edge cases and mental models for truly understanding scope. </Card> <Card title="JavaScript Promises in 10 Minutes — Web Dev Simplified" icon="video" href="https://www.youtube.com/watch?v=DHvZLI7Db8E"> Quick, clear explanation covering Promise creation, chaining, and error handling. Perfect starting point if you're new to async JavaScript. </Card> <Card title="How to Escape Async/Await Hell — Aditya Agarwal" icon="newspaper" href="https://medium.com/free-code-camp/avoiding-the-async-await-hell-c77a0fb71c4c"> The pizza-and-drinks ordering analogy makes parallel vs sequential execution crystal clear. Essential reading once you know async/await basics but want to write faster code. </Card>

Bad Examples (Avoid)

▼
markdown
复制代码
<!-- TOO GENERIC --> <Card title="Promises Tutorial" icon="newspaper" href="..."> A comprehensive guide to Promises in JavaScript. </Card> <!-- NO VALUE PROPOSITION --> <Card title="Learn Closures" icon="video" href="..."> This video explains closures in JavaScript. </Card> <!-- VAGUE, NO SPECIFICS --> <Card title="JavaScript Guide" icon="newspaper" href="..."> Everything you need to know about JavaScript. </Card> <!-- JUST RESTATING THE TITLE --> <Card title="Understanding the Event Loop" icon="video" href="..."> A video about understanding the event loop. </Card>

Words and Phrases to Avoid

AvoidWhyUse Instead
"comprehensive guide to..."Vague, overusedSpecify what's covered
"learn all about..."GenericWhat specifically will they learn?
"everything you need to know..."HyperbolicBe specific
"great tutorial on..."Subjective fillerWhy is it great?
"explains X"Too basicHow does it explain? What's unique?
"in-depth look at..."VagueWhat depth? What aspect?

Words and Phrases That Work

Good PhraseExample
"step-by-step walkthrough""Step-by-step walkthrough of building a Promise from scratch"
"visual explanation""Visual explanation with animated diagrams"
"deep dive into""Deep dive into V8's optimization strategies"
"practical examples of""Practical examples of closures in React hooks"
"the go-to reference for""The go-to reference for array method signatures"
"finally makes X click""Finally makes prototype chains click"
"perfect for beginners""Perfect for beginners new to async code"
"covers X, Y, and Z""Covers creation, chaining, and error handling"

Link Audit Process

Step 1: Check Each Link

For each resource in the concept page:

  1. Click the link — Does it load?
  2. Note the HTTP status:
StatusMeaningAction
200OKKeep, continue to content check
301/302RedirectUpdate to final URL
404Not FoundRemove or find replacement
403ForbiddenCheck manually, may be geo-blocked
5xxServer ErrorRetry later, may be temporary

Step 2: Content Verification

For each accessible link:

  1. Skim the content — Is it still accurate?
  2. Check the date — When was it published/updated?
  3. Verify JavaScript focus — Is it primarily about JS?
  4. Look for red flags — Anti-patterns, errors, outdated syntax

Step 3: Description Review

For each resource:

  1. Read current description — Is it specific?
  2. Compare to actual content — Does it match?
  3. Check for generic phrases — "comprehensive guide", etc.
  4. Identify improvements — How can it be more specific?

Step 4: Gap Analysis

After auditing all resources:

  1. Count by section — Do we meet targets?
  2. Check diversity — Beginner AND advanced? Visual AND text?
  3. Identify missing types — No MDN? No videos?
  4. Note recommendations — What should we add?

Resource Section Templates

Reference Section

▼
markdown
复制代码
## Reference <CardGroup cols={2}> <Card title="[Main Topic] — MDN" icon="book" href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/..."> Official MDN documentation covering [specific aspects]. The authoritative reference for [what it's best for]. </Card> <Card title="[Related API/Concept] — MDN" icon="book" href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/..."> [What this reference covers]. Essential reading for understanding [specific aspect]. </Card> </CardGroup>

Articles Section

▼
markdown
复制代码
## Articles <CardGroup cols={2}> <Card title="[Article Title]" icon="newspaper" href="..."> [What makes it unique/what it covers]. [Why read this one/who it's for]. </Card> <Card title="[Article Title]" icon="newspaper" href="..."> [Specific coverage]. [Value proposition]. </Card> <Card title="[Article Title]" icon="newspaper" href="..."> [Unique angle]. [Why it's worth reading]. </Card> <Card title="[Article Title]" icon="newspaper" href="..."> [What it covers]. [Best for whom]. </Card> </CardGroup>

Videos Section

▼
markdown
复制代码
## Videos <CardGroup cols={2}> <Card title="[Video Title] — [Creator]" icon="video" href="https://www.youtube.com/watch?v=..."> [What it covers/unique approach]. [Why watch/who it's for]. </Card> <Card title="[Video Title] — [Creator]" icon="video" href="https://www.youtube.com/watch?v=..."> [Specific focus]. [What makes it stand out]. </Card> <Card title="[Video Title] — [Creator]" icon="video" href="https://www.youtube.com/watch?v=..."> [Coverage]. [Value]. </Card> </CardGroup>

Books Section (Optional)

▼
markdown
复制代码
<Card title="[Book Title] — [Author]" icon="book" href="..."> [What the book covers and its approach]. [Who should read it and what they'll gain]. </Card>

Courses Section (Optional)

▼
markdown
复制代码
<CardGroup cols={2}> <Card title="[Course Title] — [Platform]" icon="graduation-cap" href="..."> [What the course covers]. [Format and who it's best for]. </Card> </CardGroup>

Resource Audit Report Template

Use this template to document audit findings.

▼
markdown
复制代码
# Resource Audit Report: [Concept Name] **File:** `/docs/concepts/[slug].mdx` **Date:** YYYY-MM-DD **Auditor:** [Name/Claude] --- ## Summary | Metric | Count | |--------|-------| | Total Resources | XX | | Working Links (200) | XX | | Broken Links (404) | XX | | Redirects (301/302) | XX | | Outdated Content | XX | | Generic Descriptions | XX | ## Resource Count vs Targets | Section | Current | Target | Status | |---------|---------|--------|--------| | Reference (MDN) | X | 2-4 | ✅/⚠️/❌ | | Articles | X | 4-6 | ✅/⚠️/❌ | | Videos | X | 3-4 | ✅/⚠️/❌ | | Courses | X | 0-3 | ✅/⚠️/❌ | --- ## Broken Links (Remove or Replace) | Resource | Line | URL | Status | Action | |----------|------|-----|--------|--------| | [Title] | XX | [URL] | 404 | Remove | | [Title] | XX | [URL] | 404 | Replace with [alternative] | --- ## Redirects (Update URLs) | Resource | Line | Old URL | New URL | |----------|------|---------|---------| | [Title] | XX | [old] | [new] | --- ## Outdated Resources (Consider Replacing) | Resource | Line | Issue | Recommendation | |----------|------|-------|----------------| | [Title] | XX | Published 2014, uses var throughout | Replace with [modern alternative] | | [Title] | XX | Pre-ES6, no mention of let/const | Find updated version or replace | --- ## Description Improvements Needed | Resource | Line | Current | Suggested | |----------|------|---------|-----------| | [Title] | XX | "A guide to closures" | "[Specific description with value prop]" | | [Title] | XX | "Learn about promises" | "[What makes it unique]. [Why read it]." | --- ## Missing Resources (Recommendations) | Type | Gap | Suggested Resource | URL | |------|-----|-------------------|-----| | Reference | No main MDN link | [Topic] — MDN | [URL] | | Article | No beginner guide | [Title] — javascript.info | [URL] | | Video | No visual explanation | [Title] — [Creator] | [URL] | | Article | No advanced deep-dive | [Title] — 2ality | [URL] | --- ## Non-JavaScript Resources (Remove) | Resource | Line | Issue | |----------|------|-------| | [Title] | XX | Primarily about C#, not JavaScript | --- ## Action Items ### High Priority (Do First) 1. **Remove broken link:** [Title] (line XX) 2. **Add missing MDN reference:** [Topic] 3. **Replace outdated resource:** [Title] with [alternative] ### Medium Priority 1. **Update redirect URL:** [Title] (line XX) 2. **Improve description:** [Title] (line XX) 3. **Add beginner-friendly article** ### Low Priority 1. **Add additional video resource** 2. **Consider adding course section** --- ## Verification Checklist After making changes: - [ ] All broken links removed or replaced - [ ] All redirect URLs updated - [ ] Outdated resources replaced - [ ] Generic descriptions rewritten - [ ] Missing resource types added - [ ] Resource counts meet targets - [ ] All new links verified working - [ ] All descriptions are specific and valuable

Quick Reference

Icon Reference

Content TypeIcon Value
MDN/Official docsbook
Articles/Blog postsnewspaper
Videosvideo
Coursesgraduation-cap
Booksbook
Related conceptsContext-appropriate

Character Guidelines

ElementGuideline
Card titleKeep concise, include creator for videos
Description sentence 1What it covers / what's unique
Description sentence 2Why read/watch / who it's for

Resource Ordering

Within each section, order resources:

  1. Most foundational/beginner-friendly first
  2. Official references before community content
  3. Most highly recommended prominently placed
  4. Advanced/niche content last

Quality Checklist

Link Verification

  • All links return 200 (not 404, 301)
  • No redirect chains
  • No hard paywalls without notice
  • All URLs are HTTPS where available

Content Quality

  • All resources are JavaScript-focused
  • No resources teaching anti-patterns
  • Publication dates appropriate for topic
  • Mix of beginner and advanced content
  • Visual and text resources included

Description Quality

  • All descriptions are specific (not generic)
  • Descriptions explain unique value
  • No "comprehensive guide to..." phrases
  • Each description is 2 sentences
  • Descriptions match actual content

Completeness

  • 2-4 MDN/official references
  • 4-6 quality articles
  • 3-4 quality videos
  • Resources ordered logically
  • Diversity in teaching styles

Summary

When curating resources for a concept page:

  1. Audit first — Check all existing links and content
  2. Identify gaps — Compare against targets (2-4 refs, 4-6 articles, 3-4 videos)
  3. Find quality resources — Search trusted sources
  4. Write specific descriptions — What's unique + why read/watch
  5. Format correctly — Proper Card syntax, icons, ordering
  6. Document changes — Use the audit report template

Remember: Resources should enhance learning, not pad the page. Every link should offer genuine value. Quality over quantity — a few excellent resources beat many mediocre ones.

文档处理

快捷安装

复制到终端去安装 Skill

npxskillsaddleonardomso/33-js-concepts--skill"resource-curator"
站长:程序员鱼皮 老鱼简历 商务合作 增值电信业务经营许可证
2026 鱼皮AI导航 | 沪ICP备19026706号-6
站长:程序员鱼皮 老鱼简历 商务合作 增值电信业务经营许可证
2026 鱼皮AI导航 | 沪ICP备19026706号-6
🔥热门工具
朱雀AI检测朱雀AI检测
朱雀AI检测助手朱雀AI检测助手
LovartLovart
老鱼简历老鱼简历
WritePass官网WritePass官网
面多多面多多
CursorCursor
星月写作星月写作
朱雀AI检测助手朱雀AI检测助手
零感AI零感AI
Skills 推荐
docx
支持专业级 Word 文档的全生命周期处理,包括从零创建结构化文档、精准编辑内容、管理修订痕迹与批注、提取纯文本或原始 XML 数据、转换为 PDF 或图像用于视觉分析,适用于法律、学术及企业场景下的高保真文档协作与自动化处理。
create-skill-file
指导 Claude 创建结构清晰、易于发现和执行的 SKILL.md 文件,涵盖命名规范、文件组织、内容编写及质量检查全流程,强调简洁性、场景化触发和渐进式信息呈现。
documentation-criteria
规范各类技术文档的生成流程与内容标准,依据变更规模和影响范围自动判断需产出的文档类型及顺序,明确每类文档的核心要素、边界划分与协同关系,确保从需求定义到落地实施的全链路可追溯、可验证、可复用。
research
面向技术方案的深度调研能力,通过网络搜索、GitHub 仓库分析和多源证据采集,支持在实施前全面评估技术选型,确保每个推荐方案均基于官方文档、活跃代码库及真实应用案例等至少两项可靠依据。
code-documentation
生成清晰的代码文档,涵盖 API 说明、项目结构和架构决策,通过示例代码与注释帮助开发者理解实现逻辑,确保技术信息准确且易于维护。