virgiliojr94/book-to-skill

45.9

Adjusted Score

45.9

Raw Score

100%

Time Factor

2026-08-28

Last Push

26.7K

Stars

Python

Language

13.4K

Lines of Code

Files

520

Pattern Hits

2026-08-29

Scan Date

0.00

HC Hit Rate

What These Metrics Mean

Adjusted Score: Primary synthetic code indicator. Raw score normalised per 1,000 lines of code and multiplied by the temporal discount factor. This is the definitive comparative metric — use it to rank repositories by AI authorship density.
Raw Score: The unmodified sum of all severity-weighted, context-multiplied pattern match scores before temporal discounting. Reflects the absolute signal strength independent of when the repository was last active.
Time Factor: The temporal discount multiplier (0–100%) applied to the raw score. Repositories last updated before ChatGPT's launch (Nov 2022) receive a 5% factor. Full signal is only assigned to repositories active in the post-adoption era (Jan 2024+).
Pattern Hits: Total count of individual pattern matches across all files and categories. A high hit count with a low score may indicate a very large codebase with isolated AI snippets; a low count with a high score indicates dense, concentrated AI signatures.
HC Hit Rate: High+Critical pattern hits per file, averaged across the repository. This orthogonal signal catches repositories where a few files are densely packed with high-severity AI tells — a strong indicator even when the normalised score appears moderate due to codebase size.
Lines of Code / Files: Total lines and files analysed. The scanner examines 94 file extensions. These denominators are used to normalise the score, enabling fair comparison between repositories of vastly different sizes.

Score History

This chart maps the temporal evolution of the adjusted synthetic code score across successive scan runs. An upward trajectory indicates ongoing incorporation of AI-generated code or expanding LLM-assisted scaffolding; a stable or declining trajectory may reflect active human refactoring, code removal, or the adoption of stricter authorship policies. The dashed secondary line (right axis) independently tracks total raw pattern hit count, which can diverge from the normalised score when codebase size changes significantly between scans.

Severity Breakdown

Classifies detected patterns by their diagnostic confidence and structural impact. CRITICAL patterns (coefficient 10) represent definitive synthetic signatures — hallucinated imports, explicit LLM attribution metadata — virtually never produced by human authors. HIGH (5) indicates strong structural tells such as cross-file repetition or cross-linguistic idioms. MEDIUM (2) covers recognisable conversational padding and AI-specific vocabulary. LOW (1) captures subtle indicators like tautological comments and generic boilerplate that require density to carry independent signal.

CRITICAL 0HIGH 0MEDIUM 37LOW 483

Directory Score Breakdown

This horizontal bar chart decomposes the repository's raw synthetic code score by top-level directory, allowing you to pinpoint precisely which modules or components carry the highest AI authorship density. Directories with disproportionately high scores relative to their size warrant targeted manual review: concentrated AI signatures often trace back to mass-generated configuration layers, auto-ported test suites, LLM-scaffolded boilerplate classes, or entire subsystems authored under heavy copilot assistance. Use this view to prioritise your human code-review effort.

Pattern Findings

The scanner identified 520 distinct pattern matches across 11 syntactic categories. Each entry below represents a discrete location in the source code where the engine recorded a statistically significant AI authorship indicator. Expand any category row to inspect the individual file paths, line numbers, code snippets, and the lexical context (CODE, COMMENT, or STRING) in which each match was detected.

Reading the findings table: The Severity column indicates the diagnostic confidence level (CRITICAL / HIGH / MEDIUM / LOW). The Context column identifies whether the match occurred inside executable code, an inline comment, or a string literal — comment-context matches receive a ×1.5 weight because LLMs systematically over-annotate. The ⚡ bolt icon marks clustered matches: three or more patterns within a 10-line window, each receiving an additional ×1.5 density multiplier as dense clusters constitute far stronger evidence of synthetic authorship than isolated hits.

Hyper-Verbose Identifiers409 hits · 423 pts

Severity	File	Line	Snippet	Context
LOW	tools/scan_generated_skill.py	122	def _frontmatter_line_numbers(lines: Sequence[str]) -> set[int]:	CODE
LOW	book_to_skill/config.py	59	def supported_formats_message() -> str:	CODE
LOW	book_to_skill/utils.py	332	def _closed_fence_line_numbers(lines: list[str]) -> set[int]:	CODE
LOW	book_to_skill/utils.py	373	def _numbered_titles_are_structural(	CODE
LOW	book_to_skill/utils.py	395	def _structural_chapter_count(text: str) -> int:	CODE
LOW	book_to_skill/parsers/docx.py	8	def extract_docx_with_python_docx(docx_path: str) -> str \| None:	CODE
LOW	book_to_skill/parsers/docx.py	44	def extract_docx_with_zipfile(docx_path: str) -> str \| None:	CODE
LOW	book_to_skill/parsers/calibre.py	10	def extract_with_ebook_convert(input_path: str) -> str \| None:	CODE
LOW	book_to_skill/parsers/rtf.py	44	def _strip_destination_groups(raw: str) -> str:	CODE
LOW⚡	tests/test_pdftotext_edge_only_boilerplate.py	41	def test_mid_page_heading_survives(self):	CODE
LOW⚡	tests/test_pdftotext_edge_only_boilerplate.py	46	def test_surrounding_body_text_intact(self):	CODE
LOW⚡	tests/test_pdftotext_edge_only_boilerplate.py	52	def test_running_headers_are_still_removed(self):	CODE
LOW⚡	tests/test_pdftotext_edge_only_boilerplate.py	59	def test_page_numbers_are_still_removed(self):	CODE
LOW⚡	tests/test_pdftotext_edge_only_boilerplate.py	64	def test_plain_running_header_still_stripped(self):	CODE
LOW	tests/test_pdftotext_edge_only_boilerplate.py	76	def test_footer_boilerplate_still_stripped(self):	CODE
LOW	tests/test_pdftotext_edge_only_boilerplate.py	89	def test_part_divider_page_is_not_stripped(self):	CODE
LOW	tests/test_pdftotext_edge_only_boilerplate.py	106	def test_genuinely_repeated_single_line_page_still_stripped(self):	CODE
LOW⚡	tests/test_pdftotext_edge_only_boilerplate.py	119	def test_hyphenated_wrap_still_rejoined(self):	CODE
LOW⚡	tests/test_pdftotext_edge_only_boilerplate.py	122	def test_short_document_keeps_content_and_drops_form_feeds(self):	CODE
LOW⚡	tests/test_pdftotext_edge_only_boilerplate.py	128	def test_mid_page_bare_number_is_kept(self):	CODE
LOW⚡	tests/test_pdftotext_edge_only_boilerplate.py	138	def test_one_word_lines_still_survive(self):	CODE
LOW	tests/test_pdftotext_edge_only_boilerplate.py	150	def test_roman_front_matter_numbers_still_stripped(self):	CODE
LOW⚡	tests/test_discovery_tax.py	44	def test_detects_three_chapters(self):	STRING
LOW⚡	tests/test_discovery_tax.py	50	def test_best_chapter_picks_largest_body_over_toc_line(self):	STRING
LOW⚡	tests/test_discovery_tax.py	58	def test_cross_reference_does_not_split(self):	STRING
LOW⚡	tests/test_discovery_tax.py	64	def test_chapter_with_title_splits(self):	STRING
LOW⚡	tests/test_discovery_tax.py	69	def test_repeated_cross_ref_does_not_refragment(self):	STRING
LOW	tests/test_discovery_tax.py	125	def test_extract_toc_detects_non_english_toc():	CODE
LOW⚡	tests/test_rtf_destination_groups.py	57	def test_chapter_heading_is_on_its_own_line(self):	CODE
LOW⚡	tests/test_rtf_destination_groups.py	62	def test_info_metadata_not_exposed(self):	CODE
LOW⚡	tests/test_rtf_destination_groups.py	68	def test_pict_binary_payload_dropped(self):	CODE
LOW⚡	tests/test_rtf_destination_groups.py	75	def test_nested_group_inside_skipped_group(self):	CODE
LOW⚡	tests/test_rtf_destination_groups.py	83	def test_content_group_after_skipped_group_is_kept(self):	CODE
LOW	tests/test_rtf_destination_groups.py	94	def test_unknown_star_destination_skipped(self):	CODE
LOW	tests/test_rtf_destination_groups.py	100	def test_field_keeps_result_drops_instruction(self):	CODE
LOW⚡	tests/test_rtf_destination_groups.py	111	def test_escaped_braces_become_literal_braces(self):	CODE
LOW⚡	tests/test_rtf_destination_groups.py	115	def test_escaped_backslash_preserved(self):	CODE
LOW⚡	tests/test_rtf_destination_groups.py	125	def test_unicode_escapes_still_decode(self):	CODE
LOW⚡	tests/test_rtf_destination_groups.py	133	def test_par_and_tab_still_convert(self):	CODE
LOW⚡	tests/test_rtf_destination_groups.py	140	def test_unterminated_skipped_group_falls_back(self):	CODE
LOW⚡	tests/test_html_block_boundaries.py	77	def test_three_chapters_detected(self, layout):	CODE
LOW⚡	tests/test_html_block_boundaries.py	80	def test_table_row_stays_on_one_line(self):	CODE
LOW⚡	tests/test_html_block_boundaries.py	85	def test_heading_text_not_glued_to_body_text(self):	CODE
LOW⚡	tests/test_html_block_boundaries.py	93	def test_inline_whitespace_preserved(self):	CODE
LOW⚡	tests/test_html_block_boundaries.py	96	def test_inline_elements_do_not_split_a_word(self):	CODE
LOW⚡	tests/test_html_block_boundaries.py	101	def test_anchor_inside_sentence_stays_inline(self):	CODE
LOW⚡	tests/test_html_block_boundaries.py	110	def test_no_leading_separator(self):	CODE
LOW⚡	tests/test_html_block_boundaries.py	113	def test_nested_blocks_collapse_to_one_separator(self):	CODE
LOW⚡	tests/test_html_block_boundaries.py	116	def test_layout_whitespace_between_blocks_dropped(self):	CODE
LOW⚡	tests/test_html_block_boundaries.py	122	def test_skip_tag_content_still_excluded(self):	CODE
LOW	tests/test_html_block_boundaries.py	173	def test_epub_chapters_detected_without_ebooklib(self, tmp_path):	CODE
LOW	tests/test_epub_image_reporting.py	38	def test_epub_extraction_reports_material_dropped_images(tmp_path, capsys):	CODE
LOW	tests/test_epub_image_reporting.py	50	def test_epub_extraction_keeps_cover_only_book_quiet(tmp_path, capsys):	CODE
LOW	tests/test_epub_image_reporting.py	60	def test_main_persists_epub_image_loss_in_source_and_total_metadata(	CODE
LOW	tests/test_tilde_expansion.py	31	def test_tilde_glob_matches_files(fake_home):	CODE
LOW	tests/test_tilde_expansion.py	43	def test_tilde_file_resolves_under_home(fake_home):	CODE
LOW	tests/test_tilde_expansion.py	54	def test_tilde_directory_is_walked(fake_home):	CODE
LOW	tests/test_tilde_expansion.py	66	def test_plain_paths_are_unchanged(tmp_path):	CODE
LOW	tests/test_tilde_expansion.py	74	def test_unresolvable_tilde_user_is_left_alone(tmp_path, monkeypatch):	CODE
LOW	tests/test_per_run_workdir.py	38	def test_default_workdir_is_unique_per_process(monkeypatch):	CODE
349 more matches not shown…

Decorative Section Separators31 hits · 100 pts

Severity	File	Line	Snippet	Context
MEDIUM⚡	tests/test_book_to_skill.py	219	# ═══════════════════════════════════════════════════════════════════════════	COMMENT
MEDIUM⚡	tests/test_book_to_skill.py	221	# ═══════════════════════════════════════════════════════════════════════════	COMMENT
MEDIUM⚡	tests/test_book_to_skill.py	278	# ═══════════════════════════════════════════════════════════════════════════	COMMENT
MEDIUM⚡	tests/test_book_to_skill.py	280	# ═══════════════════════════════════════════════════════════════════════════	COMMENT
MEDIUM⚡	tests/test_book_to_skill.py	419	# ═══════════════════════════════════════════════════════════════════════════	COMMENT
MEDIUM⚡	tests/test_book_to_skill.py	421	# ═══════════════════════════════════════════════════════════════════════════	COMMENT
MEDIUM⚡	tests/test_book_to_skill.py	488	# ═══════════════════════════════════════════════════════════════════════════	COMMENT
MEDIUM⚡	tests/test_book_to_skill.py	490	# ═══════════════════════════════════════════════════════════════════════════	COMMENT
MEDIUM⚡	tests/test_book_to_skill.py	630	# ── Hindi (Devanagari) chapter headings ────────────────────────────────	COMMENT
MEDIUM⚡	tests/test_book_to_skill.py	671	# ── Korean chapter headings ────────────────────────────────────────────	COMMENT
MEDIUM⚡	tests/test_book_to_skill.py	716	# ── Persian chapter headings ───────────────────────────────────────────	COMMENT
MEDIUM⚡	tests/test_book_to_skill.py	1028	# ── Chinese (CJK) chapter headings ──────────────────────────────────────	COMMENT
MEDIUM⚡	tests/test_book_to_skill.py	1571	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_book_to_skill.py	1573	# ---------------------------------------------------------------------------	COMMENT
MEDIUM⚡	tests/test_book_to_skill.py	2032	# ═══════════════════════════════════════════════════════════════════════════	COMMENT
MEDIUM⚡	tests/test_book_to_skill.py	2034	# ═══════════════════════════════════════════════════════════════════════════	COMMENT
MEDIUM⚡	tests/test_book_to_skill.py	2083	# ═══════════════════════════════════════════════════════════════════════════	COMMENT
MEDIUM⚡	tests/test_book_to_skill.py	2085	# ═══════════════════════════════════════════════════════════════════════════	COMMENT
MEDIUM⚡	tests/test_book_to_skill.py	2152	# ═══════════════════════════════════════════════════════════════════════════	COMMENT
MEDIUM⚡	tests/test_book_to_skill.py	2154	# ═══════════════════════════════════════════════════════════════════════════	COMMENT
MEDIUM	tests/test_book_to_skill.py	20	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_book_to_skill.py	22	# ---------------------------------------------------------------------------	COMMENT
MEDIUM	tests/test_book_to_skill.py	44	# ═══════════════════════════════════════════════════════════════════════════	COMMENT
MEDIUM	tests/test_book_to_skill.py	46	# ═══════════════════════════════════════════════════════════════════════════	COMMENT
MEDIUM	tests/test_book_to_skill.py	539	# ═══════════════════════════════════════════════════════════════════════════	COMMENT
MEDIUM	tests/test_book_to_skill.py	541	# ═══════════════════════════════════════════════════════════════════════════	COMMENT
MEDIUM	tests/test_book_to_skill.py	1118	# ── Kangxi-radical numerals (U+2F00 block) ──────────────────────────────	COMMENT
MEDIUM	tests/test_book_to_skill.py	2115	# ═══════════════════════════════════════════════════════════════════════════	COMMENT
MEDIUM	tests/test_book_to_skill.py	2117	# ═══════════════════════════════════════════════════════════════════════════	COMMENT
MEDIUM⚡	tests/test_book_to_skill.py	174	# ═══════════════════════════════════════════════════════════════════════════	STRING
MEDIUM⚡	tests/test_book_to_skill.py	176	# ═══════════════════════════════════════════════════════════════════════════	STRING

Excessive Try-Catch Wrapping24 hits · 25 pts

Severity	File	Line	Snippet	Context
LOW	tools/discovery_tax.py	57	except Exception:	CODE
LOW	tools/discovery_tax.py	65	except Exception:	CODE
MEDIUM	tools/discovery_tax.py	61	def token_method() -> str:	CODE
LOW	book_to_skill/dependencies.py	122	except Exception as exc:	CODE
LOW	book_to_skill/parsers/docx.py	39	except Exception as e:	CODE
LOW	book_to_skill/parsers/docx.py	88	except Exception as e:	CODE
LOW	book_to_skill/parsers/docx.py	113	except Exception as e:	CODE
LOW	book_to_skill/parsers/calibre.py	24	except Exception as e:	CODE
LOW	book_to_skill/parsers/html.py	112	except Exception:	CODE
LOW	book_to_skill/parsers/pdf.py	88	except Exception as e:	CODE
LOW	book_to_skill/parsers/pdf.py	108	except Exception:	CODE
LOW	book_to_skill/parsers/pdf.py	121	except Exception:	CODE
LOW	book_to_skill/parsers/pdf.py	128	except Exception as e:	CODE
LOW	book_to_skill/parsers/pdf.py	140	except Exception as e:	CODE
LOW	book_to_skill/parsers/pdf.py	166	except Exception as e:	CODE
LOW	book_to_skill/parsers/pdf.py	186	except Exception:	CODE
LOW	book_to_skill/parsers/pdf.py	195	except Exception:	CODE
LOW	book_to_skill/parsers/pdf.py	207	except Exception:	CODE
LOW	book_to_skill/parsers/rtf.py	143	except Exception as e:	CODE
LOW	book_to_skill/parsers/text.py	19	except Exception as e:	CODE
LOW	book_to_skill/parsers/epub.py	38	except Exception as e:	CODE
LOW	book_to_skill/parsers/epub.py	120	except Exception:	CODE
LOW	book_to_skill/parsers/epub.py	123	except Exception as e:	CODE
LOW	book_to_skill/parsers/epub.py	137	except Exception:	CODE

Unused Imports19 hits · 19 pts

Severity	File	Line	Context
LOW	tools/scan_generated_skill.py	4	CODE
LOW	tools/discovery_tax.py	31	CODE
LOW	tools/evals/paper_flat.py	6	CODE
LOW	tools/evals/manifest.py	6	CODE
LOW	tools/evals/replay.py	3	CODE
LOW	tools/evals/score.py	3	CODE
LOW	book_to_skill/__init__.py	1	CODE
LOW	book_to_skill/__init__.py	1	CODE
LOW	book_to_skill/__init__.py	1	CODE
LOW	book_to_skill/__init__.py	2	CODE
LOW	book_to_skill/utils.py	1	CODE
LOW	book_to_skill/sanitize.py	1	CODE
LOW	book_to_skill/dependencies.py	1	CODE
LOW	book_to_skill/parsers/docx.py	1	CODE
LOW	book_to_skill/parsers/calibre.py	1	CODE
LOW	book_to_skill/parsers/html.py	1	CODE
LOW	book_to_skill/parsers/pdf.py	1	CODE
LOW	book_to_skill/parsers/text.py	1	CODE
LOW	book_to_skill/parsers/epub.py	1	CODE

Deep Nesting16 hits · 16 pts

Severity	File	Line	Context
LOW	tools/validate_skill.py	102	CODE
LOW	tools/evals/score.py	15	CODE
LOW	book_to_skill/utils.py	395	CODE
LOW	book_to_skill/utils.py	662	CODE
LOW	book_to_skill/utils.py	698	CODE
LOW	book_to_skill/utils.py	757	CODE
LOW	book_to_skill/dependencies.py	244	CODE
LOW	book_to_skill/parsers/docx.py	8	CODE
LOW	book_to_skill/parsers/docx.py	44	CODE
LOW	book_to_skill/parsers/docx.py	93	CODE
LOW	book_to_skill/parsers/docx.py	58	CODE
LOW	book_to_skill/parsers/pdf.py	30	CODE
LOW	book_to_skill/parsers/pdf.py	112	CODE
LOW	book_to_skill/parsers/pdf.py	171	CODE
LOW	book_to_skill/parsers/rtf.py	44	CODE
LOW	book_to_skill/parsers/epub.py	63	CODE

Over-Commented Block13 hits · 13 pts

Severity	File	Line	Snippet	Context
LOW	cliff.toml	1	# git-cliff configuration — generates CHANGELOG.md from Conventional Commit	COMMENT
LOW	tools/scan_generated_skill.py	61	),	COMMENT
LOW	book_to_skill/utils.py	61	# Chinese/Japanese book collapses it to a handful of tokens; count them directly.	COMMENT
LOW	book_to_skill/utils.py	101		COMMENT
LOW	book_to_skill/utils.py	121	# uppercase Roman numeral. Lowercase ("i: Loomings") is only accepted inside	COMMENT
LOW	book_to_skill/utils.py	201	# Korean chapter headings: "제1장 총칙", "## 제4장 근로시간과 휴식", "제6장의2 …".	COMMENT
LOW	book_to_skill/utils.py	221	# small ordinal map (1–34) with longest-prefix matching so compounds	COMMENT
LOW	book_to_skill/utils.py	621	num = _chapter_number(line)	COMMENT
LOW	book_to_skill/sanitize.py	21	0x2064, # INVISIBLE PLUS	COMMENT
LOW	book_to_skill/sanitize.py	81	)	COMMENT
LOW	book_to_skill/parsers/docx.py	1	from __future__ import annotations	COMMENT
LOW	book_to_skill/parsers/pdf.py	1	from __future__ import annotations	COMMENT
LOW	.github/workflows/deploy-docs.yml	41	# Single-source: the Guide and Skill Reference pages are the repo-root	COMMENT

Self-Referential Comments3 hits · 10 pts

Severity	File	Line	Snippet	Context
MEDIUM⚡	tests/test_book_to_skill.py	299	# Create a valid text file	COMMENT
MEDIUM⚡	tests/test_book_to_skill.py	301	# Create a file that will fail (unsupported extension, garbage bytes)	COMMENT
MEDIUM	tests/test_book_to_skill.py	1433	# Create a malicious DOCX	COMMENT

Modern AI Meta-Vocabulary2 hits · 5 pts

Severity	File	Line	Snippet	Context
MEDIUM	docs/research/progressive-disclosure-evals.md	136	run.py # experiment orchestration / dry-run / budget gate	CODE
MEDIUM	docs/research/progressive-disclosure-evals.md	486	### PD-10 — Optional Hybrid RAG reference baseline	COMMENT

Redundant / Tautological Comments1 hit · 2 pts

Severity	File	Line	Snippet	Context
LOW	book_to_skill/utils.py	716	# Check if it has glob wildcards	COMMENT

AI Slop Vocabulary1 hit · 2 pts

Severity	File	Line	Snippet	Context
LOW	book_to_skill/parsers/html.py	71	# boundary would just add trailing spaces — drop it and keep	COMMENT

Modern Structural Boilerplate1 hit · 1 pts

Severity	File	Line	Snippet	Context
LOW	book_to_skill/__init__.py	4	__all__ = ["resolve_input_files", "extract_single_file", "main", "ExtractionError"]	CODE

Analysis Overview

What These Metrics Mean

Score History

Severity Breakdown

Directory Score Breakdown

Pattern Findings