Milan Jovanovic Blog Skill

Overview

This skill provides access to Milan Jovanovic's curated .NET blog content, filtered to November 2025+ (aligned with .NET 10 GA). It helps developers discover and apply proven patterns for Clean Architecture, Domain-Driven Design, CQRS, Entity Framework Core, and ASP.NET Core.

Content scope: Articles published November 2025 and later, with promotional content stripped.

When to Use This Skill

Use this skill when:

• Working with .NET projects that could benefit from architectural patterns

• Implementing Clean Architecture, DDD, CQRS, or Vertical Slice patterns

• Configuring Entity Framework Core or ASP.NET Core

• Looking for proven .NET code patterns and examples

• Researching .NET 10/Aspire features

Quick Start

Search by Keywords

python scripts/core/find_articles.py search clean architecture cqrs

Filter by Tag

python scripts/core/find_articles.py tag ef-core

Resolve doc_id to Path

python scripts/core/find_articles.py resolve milanjovanovic-tech-blog-{slug}

Natural Language Query

python scripts/core/find_articles.py query "how to implement CQRS"

List Recent Articles

python scripts/core/find_articles.py list --sort date --limit 10

Tag Taxonomy

Tag Description

clean-architecture

Clean/Onion/Hexagonal Architecture patterns

ddd

Domain-Driven Design (aggregates, value objects, domain events)

cqrs

Command Query Responsibility Segregation

mediatr

MediatR library usage patterns

ef-core

Entity Framework Core optimization and patterns

aspnet-core

ASP.NET Core patterns and Minimal APIs

modular-monolith

Modular Monolith architecture

vertical-slice

Vertical Slice Architecture

dotnet-10

.NET 10 features and patterns

aspire

.NET Aspire patterns

result-pattern

Result pattern for error handling

outbox-pattern

Transactional outbox pattern

specification-pattern

Specification pattern

repository-pattern

Repository pattern

validation

FluentValidation patterns

testing

Unit/integration testing patterns

Path Resolution

Windows PowerShell users: Avoid cd && python chains - use absolute paths or run from repo root to prevent path doubling issues.

Script location: All scripts are in scripts/ relative to skill root.

Canonical content: Scraped articles are stored in canonical/milanjovanovic-tech/blog/ .

Index Management

Check Index Stats

python scripts/management/manage_index.py stats

Verify Index Integrity

python scripts/management/manage_index.py verify

Refresh Index (After Scraping)

python scripts/management/refresh_index.py

Scraping (Use /scrape-posts Command)

For scraping operations, use the /milan-jovanovic:scrape-posts command which handles:

• Pre-filtering optimization - Parses dates from listing page before scraping individual articles

• Date filtering (November 2025+)

• Content cleanup (removes promotional sections)

• Idempotent updates (skip unchanged articles via content hash comparison)

Efficiency Optimizations

The scraping workflow uses pre-filtering to minimize firecrawl API calls:

Scenario Without Optimization With Optimization Savings

No new articles 10+ requests 1-2 requests 80-90%

1 new article 10+ requests 2-3 requests 70-80%

Force (unchanged) 10+ requests 10+ requests (skips writes) I/O savings

How it works:

• Scrape listing page only (1-2 requests)

• Parse dates from listing markdown (no network)

• Compare against index to identify new articles

• Scrape ONLY articles not already indexed

Check for New Articles (Pre-Filter)

Before scraping, check what needs updating:

Check for new articles since November 2025

python scripts/core/check_new_articles.py .claude/temp/listing.md --json --since 2025-11-01

Force mode - include existing articles for re-check

python scripts/core/check_new_articles.py .claude/temp/listing.md --json --force

URLs only output

python scripts/core/check_new_articles.py .claude/temp/listing.md --urls-only

Output includes to_scrape list with in_index and content_hash for smart handling.

Python API

For programmatic access, use the public API:

from milan_jovanovic_api import ( search_articles, get_by_tag, resolve_doc_id, get_article_content, )

Search by keywords

results = search_articles(['clean-architecture', 'cqrs'])

Get articles by tag

ef_articles = get_by_tag('ef-core')

Resolve doc_id to path

path = resolve_doc_id('milanjovanovic-tech-blog-some-slug')

Get article content

content = get_article_content('milanjovanovic-tech-blog-some-slug')

Content Cleanup

Scraped articles have promotional content removed:

• Sponsor sections (between title and first H2)

• Promotional footer ("Whenever you're ready, there are X ways...")

• Newsletter signup sections

• Course CTAs

• Reading time metadata

All educational content, code blocks, and internal links are preserved.

Related Components

• Command: /milan-jovanovic:scrape-posts

• Scrape new articles

• Agent: blog-advisor

• Proactive project analysis and recommendations

Troubleshooting

No Results Found

• Check if index exists: python scripts/management/manage_index.py count

• If count is 0, run scrape: /milan-jovanovic:scrape-posts

• Verify tags with: python scripts/core/find_articles.py tag --list

Path Issues on Windows

Use PowerShell or prefix Git Bash with MSYS_NO_PATHCONV=1 :

MSYS_NO_PATHCONV=1 python scripts/core/find_articles.py search cqrs

Version History

• v1.1.0 (2025-12-27): Pre-filtering optimization - 80-90% reduction in firecrawl API calls

• v1.0.0 (2025-12-22): Initial release - November 2025+ articles, full tag taxonomy

Last Updated: 2025-12-27