Adding custom sections to messages in order to develop a Thunderbird plugin that improves user experience requires traversing the complexities of the messageDisplayScripts API and making sure the right permissions are established. Problems like scripts not running as intended emphasize how important it is to handle errors, have the right file locations, and comprehend Thunderbird's API.