Every number on a Blackbox Chess report, defined exactly, with the least amount of data we need before we show it. If a card is missing from your report, it is because there was not enough data for it yet, not because the answer was zero.
Stockfish, a chess engine, looks at a position and gives it a number: how far ahead one side is. The unit is the pawn. An evaluation of 1.0 in your favor means you are ahead by about the value of one pawn, even if no pawn has actually been won.
We read that number before and after each of your moves. If it gets worse for you, the move cost you something, and the size of the drop is how much.
An error is one of your moves that made the evaluation of your position worse by 1.0 (about one pawn) or more.
A blunder is one of your moves that made it worse by 2.0 (about two pawns) or more. Every blunder is also an error.
A game has three phases: the opening, the middlegame and the endgame. The report shows two things for each. The percentage is that phase's share of all your mistakes. The rate is your errors per 100 of your own moves in that phase.
The weakest phase is the one with the highest rate, not the largest share. The middlegame has the most moves in it, so it nearly always has the most mistakes. Counting per 100 moves removes that advantage and shows where you are actually weakest.
We only rank by rate when at least 5 of your games recorded move counts, and a phase only competes if you made at least 40 moves in it. Older reports, made before we recorded move counts, name the phase with the most mistakes.
A winning position is one where the engine had you ahead by 1.5 pawns or more after one of your moves. Your conversion figure is how many of the games that reached a winning position you went on to win.
A win has slipped when the evaluation falls from winning to below 0.5 and never gets back to winning. The move shown is your last move that took it below 0.5. A game you were winning and lost on time, without the evaluation ever falling, is counted as not won but has no slip move.
The card appears once at least 3 of your games have slipped in this way.
For each of your moves we work out the time you could afford to spend on it: the clock you had left, spread over the moves still to play (we assume at least 10 more, or 40 minus the move number if that is more), plus any increment. At the start of a 3+2 game that is about 6.5 seconds a move; with 40 seconds left on move 30 of that game it is 6 seconds.
Low on time means you could afford less than half of what you could at the start of the game. Every move is then put in one group: low on time, moved quickly (used under a quarter of the time you could afford), long think (used 2 times the time you could afford or more), or normal. Moves from memorized opening theory, positions with only one or two legal moves, and positions where either side was already 6 pawns up are not counted.
We also count the games you lost on time (and how many of those you were winning, 3 pawns or more ahead, when your time ran out), the games where your clock fell under a tenth of the game's time with more than 5 moves still to play while your opponent still had more (the same rule Lichess uses), and the games where you spent 15% or more of the game's time on a single move. The game's time is the starting clock plus 40 times the increment.
Your clock habit is only named with 50 or more games, and only when two checks agree: you made at least 3 more blunders in that situation than players at your speed usually do, and at least 3 more than your own normal moves would suggest. Moving quickly on its own is not a fault. Across real players, quick moves are blunders less often than slow ones, because people move fast when a position is easy. So we only call out quick moves when yours go wrong more than both your own normal moves and other players' quick moves. "Players at your speed" means recently analyzed Blackbox games at the same speed: bullet, blitz or rapid.
This needs clock times in the game record. Games from Lichess and Chess.com carry them; uploaded game files often do not.
An endgame is the last phase of a game, when most of the pieces have been traded off. We note the evaluation at the first moment it was your move in the endgame. Winning means you were ahead by 1.5 pawns or more, worse means behind by 1.5 or more, and level is anything in between.
You held an endgame if you won one you entered winning, or did not lose one you entered level. An endgame you entered worse had nothing to hold, so it counts as held whatever the result. Won always means you won the game: a winning endgame lost on time is not won.
The card appears once you have reached 5 endgames. A type of endgame, such as rook endgames, is only named as the one that cost you the most once you have played 4 of that type.
Every opening has a book: the established moves that strong players have settled on. We follow each of your games move by move until your first move that is not in the book.
A costly exit is a game where that move made your position worse by 1.0 (about one pawn) or more. If you left the book with a move that cost less than that, the game is not counted. There is at most one exit per game.
Openings are grouped by name and by the color you played, for example the French Defense as Black. An opening is listed once you have played it 3 times, and the card appears once there are 3 costly exits in total. The move shown for each opening is a real move from one of your games: the exit that cost the most.
The endgame trainer, part of the subscription, groups your endgame positions into families such as pawn endings and rook endings, and picks one to focus on. Every position in the trainer is a mistake from one of your own games. So a family with more positions is a kind of endgame that goes wrong for you more often.
Each position is worth 1 point once you have mastered it, which means solving it with no help twice, at least a day apart. It is worth 0.6 after one solve with no help, 0.3 after a solve with help, and nothing until then. A family's progress is the points you have earned out of its number of positions. Solving a few positions well does not finish a family: only working through all of it does.
The focus is the family with the most points still to earn. A position you got wrong the last time you tried it counts an extra 0.5, so a family you keep getting wrong comes before one of the same size that you have not reached yet. The focus stays on your biggest unfinished family until you have worked it down to the size of the next one.
Every chess judgment comes from Stockfish: the evaluations, the better moves, and which moves count as mistakes. Nothing else decides what is good or bad chess here.
The names and descriptions of the mistake patterns on your report are fixed text written by us. The same pattern always gets the same words.
Two things are written by an AI language model: the scripts for personalized opening videos, and the answers to questions you ask in the endgame trainer. The model is given the engine's analysis of your position and asked to put it into plain words. It is not asked to analyze the chess itself.
Before you see any of that text, a program checks it against the engine's analysis and the board. A video script that names a move the engine did not produce, or gives a piece the wrong color, is rejected and rewritten. An endgame answer with a false statement about the position is sent back once to be corrected; any sentence that is still false is removed, and if nothing true is left the answer is withheld. The answer moves of practice drills are checked by the engine before a drill is emailed to you.